improve texinfo manual

Signed-off-by: Mattias Andrée <maandree@member.fsf.org>

1 files changed, 85 insertions, 77 deletions

diff --git a/doc/info/unstickpixels.texinfo b/doc/info/unstickpixels.texinfo
index 74d1c93..2f4e8c4 100644
--- a/doc/info/unstickpixels.texinfo
+++ b/doc/info/unstickpixels.texinfo
@@ -1,95 +1,103 @@
 \input texinfo   @c -*-texinfo-*-
-
 @c %**start of header
-@setfilename unstickpixels.info
-@settitle unstickpixels
-@afourpaper
 @documentencoding UTF-8
-@documentlanguage en
-@finalout
-@c %**end of header
-
-
-@dircategory Miscellaneous
-@direntry
-* unstickpixels: (unstickpixels).    Screen loop to try to unstick stuck pixels
-@end direntry
-
-
+@include reusable/macros.texinfo
 @copying
-Copyright @copyright{} 2013 Mattias Andrée
+@c --------------------------------------------------------------------------------
+Copyright @copyright{} 2013, 2015  @w{Mattias Andrée @e{maandree@@member.fsf.org}}
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.3 or
-any later version published by the Free Software Foundation; with no
-Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
-Texts. A copy of the license is included in the section entitled
-``GNU Free Documentation License''.
+under the terms of the GNU Free Documentation License, Version@tie{}1.3 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``Free Software Needs Free Documentation'', the
+``GNU General Public License'', the ``GNU Free Documentation License'',
+with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the
+license is included in the section entitled ``GNU Free Documentation License''.
 @end quotation
+@c THIS WAS LAST CHANGED 2015-DECEMBER-27 UTC
+@c When updated, please remember to update hardcopy-copying.texinfo too.
+@c --------------------------------------------------------------------------------
 @end copying
 
-@ifnottex
-@node Top
-@top unstickpixels -- Screen loop to try to unstick stuck pixels
-@insertcopying
-@end ifnottex
-
-@titlepage
-@title unstickpixels
-@subtitle Screen loop to try to unstick stuck pixels
-@author by Mattias Andrée (maandree)
-
-@page
-@vskip 0pt plus 1filll
-@insertcopying
-@end titlepage
-
-@contents
-
-
-
-@menu
-* Overview::                        Brief overview of @command{unstickpixels}.
-* Invoking::                        Executing @command{unstickpixels}.
-* GNU Free Documentation License::  Copying and sharing this manual.
-@end menu
-
-
-
-@node Overview
-@chapter Overview
-
-@command{unstickpixels} tries to unstick stuck pixels.
-
-Dead (always black) pixels are hard to revive, stuck pixels
-on the other hand are more probable to get fixed.
-
-This program should be run under the Linux VT. It works by
-cycling the colour on the screen between sRGB(100 %, 0, 0),
-sRGB(0, 100 %, 0) and sRGB(0, 0, 100 %), as fast as possible.
-If you want to slow down the cycling you can add, as the only
-argument, the millisecond time sleep between the colours.
-
-
-@node Invoking
-@chapter Invoking
+@setfilename unstickpixels.info
+@settitle unstickpixels
+@documentlanguage en_GB
+@include titlepage-data.texinfo
 
-@emph{Do not used this if you have epilepsia}
+@c  You can change the title of the document in dir by compiling with
+@c    INFO_FLAGS='-c CATEGORY=your_new_category'
+@ifclear CATEGORY
+@set CATEGORY Miscellaneous
+@end ifclear
 
-@command{unstickpixels} will not run in a graphical environment.
-If you are using a graphical environment and do not know how
-to access the Linux VT, here is how you do it: press @kbd{Ctrl+Alt+F1},
-if this does not open non-graphical login screen, press @kbd{Alt+Right}
-until you get one. To get back to graphical environment, hold
-down @kbd{Alt+Right} until it appears.
+@dircategory @value{CATEGORY}
+@direntry
+* unstickpixels: (unstickpixels).    @value{subtitle}
+@end direntry
 
-Run @command{unstickpixels} without arguments.
+@documentdescription
+User manual for unstickpixels.
+A Screen loop to try to unstick stuck pixels.
+@end documentdescription
+@c %**end of header
 
 
-@node GNU Free Documentation License
-@appendix GNU Free Documentation License
-@include fdl.texinfo
+@iftex
+@c @set USLETTER
+@c @set AFOURPAPER
+@c @set AFIVEPAPER
+@c @set SMALLBOOK
+
+@c @set HARDCOPY
+@c @set CROPMARKS
+@c @set SKIPCHAPTERNEWPAGE
+@c @set SKIPFONTTEXTSIZE
+@end iftex
+@c @set LOGO
+@c @set DOUBLEHEADINGS
+@c @set SINGLEHEADINGS
+@c @set AMERICANSPACING
+@c @set NOFINALOUT
+
+@ignore
+
+  CROPMARKS has no effect unless HARDCOPY is set. CROPMARKS
+  and AFIVEPAPER (or actually @cropmarks and @afivepaper) does
+  not play well together.
+
+  You can configure how TeX output files should look by uncommenting
+  @set commands above. Do not uncomment more than one of the paper
+  sizes (USLETTER, AFOURPAPER, AFIVEPAPER and SMALLBOOK); if none is
+  uncomment AFOURPAPER will be set unless HARDCOPY is set, in which
+  case SMALLBOOK will be set. However, if you do not want to modify
+  this source file, you can run `make` with for example
+  `TEXINFO_FLAGS='--texinfo="@set HARDCOPY"'`.
+
+  Finally, you can include, on the front page, the version of unstickpixels
+  that the manual is up to date with, by setting the value of VERSION
+  to the version of unstickpixels, as well as date of the last update by
+  setting DATE, and edition by setting EDITION. This is intended for
+  printed manuals. The date is recommended to not be more accurate,
+  or less accurate, than to the month. The edition should be formatted
+  as, for example, ``1@sup{st}''.
+
+@end ignore
+
+@comment You can see these too with TEXINFO_FLAGS.
+@c @paragraphindent asis
+@c @firstparagraphindent none
+@c @exampleindent asis
+@c @kbdinputstyle distinct
+
+@include reusable/paper.texinfo
+
+
+@include hardcopy-copying.texinfo
+@include reusable/titlepage.texinfo
+@setheadings{}
+
+@include content.texinfo
 
 @bye