[Groff-commit] groff ./ChangeLog doc/Makefile.in doc/groff.css...

[Gaius Mulley]

CVSROOT:        /cvsroot/groff
Module name:    groff
Branch:         
Changes by:     Gaius Mulley <address@hidden>   05/11/28 08:40:23

Modified files:
        .              : ChangeLog 
        doc            : Makefile.in groff.css webpage.ms 
        tmac           : groff_www.man www.tmac 

Log message:
        * doc/Makefile.in: separate rule for webpage.html so that extra
        command line options can be passed to grohtml.
        * doc/groff.css: changed all margins to 0%.
        * doc/webpage.ms: now uses new macros ALN, LNS and LNE
        so that left navigation is exploited. Also updated webpage to
        contain new sections on licences, mailing lists, cvs/ftp
        access, groff dependencies and bug reports.
        * tmac/groff_www.man: documented the new macros ALN, LNS and LNE.
        * tmac/www.tmac: implemented the new macros ALN, LNS and LNE.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/ChangeLog.diff?tr1=1.863&tr2=1.864&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/doc/Makefile.in.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/doc/groff.css.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/doc/webpage.ms.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/tmac/groff_www.man.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/tmac/www.tmac.diff?tr1=1.43&tr2=1.44&r1=text&r2=text

Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.863 groff/ChangeLog:1.864
--- groff/ChangeLog:1.863       Fri Nov 25 23:02:01 2005
+++ groff/ChangeLog     Mon Nov 28 08:40:21 2005
@@ -1,3 +1,15 @@
+2005-11-28  Gaius Mulley  <address@hidden>
+
+       * doc/Makefile.in: separate rule for webpage.html so that extra
+         command line options can be passed to grohtml.
+       * doc/groff.css: changed all margins to 0%.
+       * doc/webpage.ms: now uses new macros ALN, LNS and LNE
+         so that left navigation is exploited. Also updated webpage to
+         contain new sections on licences, mailing lists, cvs/ftp
+         access, groff dependencies and bug reports.
+       * tmac/groff_www.man: documented the new macros ALN, LNS and LNE.
+       * tmac/www.tmac: implemented the new macros ALN, LNS and LNE.
+       
 2005-11-25  Gaius Mulley  <address@hidden>
 
        * src/devices/grohtml/post-html.cpp
Index: groff/doc/Makefile.in
diff -u groff/doc/Makefile.in:1.19 groff/doc/Makefile.in:1.20
--- groff/doc/Makefile.in:1.19  Fri Nov 18 21:12:56 2005
+++ groff/doc/Makefile.in       Mon Nov 28 08:40:23 2005
@@ -127,6 +127,10 @@
                  -Thtml -ms >$@
 
 webpage.html: webpage.ms gnu.png gnu.eps groff.css
+       $(GROFF) -P-j`basename $< | sed -e 's|.ms$$||'` \
+                 -P-n -P-r -P-p -P-b -P-I`basename $< | sed -e 's|.ms$$||'` \
+                -P-D$(imagedir) -Thtml -ms >$@
+
 webpage.ps: gnu.eps
 
 grnexmpl.ps: grnexmpl.me grnexmpl.g
Index: groff/doc/groff.css
diff -u groff/doc/groff.css:1.1 groff/doc/groff.css:1.2
--- groff/doc/groff.css:1.1     Wed Oct 13 07:24:46 2004
+++ groff/doc/groff.css Mon Nov 28 08:40:23 2005
@@ -1,9 +1,9 @@
 
 body { 
-  margin-top: 5%;
-  margin-left: 5%;
-  margin-right: 5%;
-  margin-bottom: 5%;
+  margin-top: 0%;
+  margin-left: 0%;
+  margin-right: 0%;
+  margin-bottom: 0%;
   background-color: white;
   color: black;
 }
Index: groff/doc/webpage.ms
diff -u groff/doc/webpage.ms:1.20 groff/doc/webpage.ms:1.21
--- groff/doc/webpage.ms:1.20   Mon Oct 17 07:06:42 2005
+++ groff/doc/webpage.ms        Mon Nov 28 08:40:23 2005
@@ -14,6 +14,7 @@
 .\" .HEAD "<link rel=""icon"" type=""image/png"" 
href=""http://www.gnu.org/graphics/gnu-mini.png""; >"
 .
 .mso www.tmac
+.ALN "#eeeeee" 30
 .
 .de blm-macro
 .  nr tmp \\n[.i]
@@ -22,7 +23,7 @@
 ..
 .blm blm-macro
 .
-.HX 0
+.HX 1
 .
 .defcolor mydarkred rgb 0.65f 0.1f 0.2f
 .defcolor mydarkgreen rgb 0.1f 0.5f 0.2f
@@ -35,37 +36,24 @@
 .
 Home of Groff (GNU Troff).
 .
-.
 .HTML-IMAGE-LEFT
 .PSPIC -L gnu.eps 2i 2i
 .ie r ps4html \
-.  nop \v'-0.66i'\h'2.0i'\s[100]\*[GNU] Troff\s0
+.  nop \v'-0.66i'\h'2.0i'\s[80]\*[GNU] Troff\s0
 .el \
 .  nop \v'-0.66i'\h'2.0i'\s[60]\*[GNU] Troff\s0
 .HTML-IMAGE-END
 .
 .HR
-.HnS 1
-GNU Troff (\c
-.URL http://\:groff.ffii.org/ Groff )
-\[em] a
-.URL http://\:www.gnu.org/ GNU
-project.
-.HnE
-.HR
-.LK
 .
-.LP
-.DC T HE mydarkred
-groff (GNU Troff) software
-is a typesetting package which reads plain text mixed with
-formatting commands and produces formatted output.
-Groff now supports HTML.
+.LNS
 .
+.DC T HIS mydarkred
+is the home page for groff (\c
+.URL http://\:www.gnu.org/ GNU
+Troff).  Groff is a software typesetting package which reads plain
+text mixed with formatting commands and produces formatted output.
 .
-.SH
-Download
-
 The source code of the currently released versions of groff is
 available at the 
 .URL "http://\:groff.ffii.org/\:groff/"; "FFII host (Germany)" ,
@@ -74,8 +62,7 @@
 .
 The USA site also contains older, obsolete versions.
 
-The most actual pre-release, development version is available from a
-CVS repository, see below.
+The development version is available from a CVS repository, see below.
 .
 Development snapshots (produced twice a day from the CVS repository)
 can be downloaded from
@@ -84,8 +71,11 @@
 For a special version of groff on the Microsoft operating systems, see
 .URL "http://\:gnuwin32.sf.net/\:packages/\:groffl.htm"; "Groff for Windows" .
 
-GNU troff is released under the
-.URL http://\:www.gnu.org/\:copyleft/\:gpl.html "GNU Copyright License" .
+Groff was originally written and maintained by James Clark, however it
+is now maintained by
+.MTO address@hidden:nessie.mcc.ac.uk "Ted Harding"
+and
+.MTO address@hidden:gnu.org "Werner Lemberg" .
 
 User issues lead:
 .MTO address@hidden:nessie.mcc.ac.uk "Ted Harding" .
@@ -93,10 +83,28 @@
 Technical issues lead:
 .MTO address@hidden:gnu.org "Werner Lemberg" .
 .
+.LNE
+.
+\s[-4]\f[I]This document was produced using
+.URL http://groff.ffii.org/ groff-\n[.x].\n[.y].\n[.Y] .
+.br
+The image at the top has been contributed by Imogen Mulley (born 1991),
+based on a similar picture found on the
+.URL http://www.gnu.org "GNU server" .
+.HR
+.SH
+Licence
+.LP
+GNU troff is released under the
+.URL http://\:www.gnu.org/\:copyleft/\:gpl.html "GNU Copyright License" .
+The documentation is released under the
+.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "Free Documentation License" .
+Groff is an official GNU project as defined on
+.URL http://\:savannah.gnu.org savannah .
 .
 .SH
 README
-
+.LP
 This is the GNU groff document formatting system.
 The version number is given in the file VERSION.
 
@@ -120,6 +128,9 @@
 The file PROBLEMS describes various problems that have been encountered in
 compiling, installing, and running groff.
 
+.SH
+CVS and FTP access
+.LP
 The most recent released version of groff is always available by
 .URL "ftp://\:ftp.gnu.org/\:gnu/\:groff"; "anonymous ftp" .
 
@@ -186,7 +197,9 @@
 .ft P
 .fi
 .in
-
+.SH
+Groff dependancies
+.LP
 Depending on your requirements, you may need at least some of the
 following tools to build groff directly from its source:
 
@@ -215,6 +228,9 @@
 If you don't intend to produce output in either of these formats, then
 these packages are unnecessary.
 
+.SH
+Bug reports
+.LP
 Please report bugs using the form in the file BUG-REPORT; the idea of this
 is to make sure that FSF has all the information it needs to fix the bug.
 At the very least, read the BUG-REPORT form and make sure that you supply
@@ -223,6 +239,9 @@
 BUG-REPORT: this will enable us to determine whether it really is a bug or
 not.
 
+.SH
+Mailing lists
+.LP
 Three mailing lists are available:
 
 .ULS
@@ -260,17 +279,9 @@
 Each of these web pages also provides a link to a browseable archive of
 postings to the corresponding mailing list.
 
-GNU groff was written by
-.MTO address@hidden:jclark.com "James Clark" .
-It is now maintained by
-.MTO address@hidden:nessie.mcc.ac.uk "Ted Harding"
-and
-.MTO address@hidden:gnu.org "Werner Lemberg" .
-.
-.
 .SH
 NEWS VERSION 1.19.2
-.
+.LP
 .SH 2 troff
 
 .ULS
@@ -530,7 +541,7 @@
 .
 .SH
 NEWS VERSION 1.19.1
-.
+.LP
 .SH 2
 groff
 
@@ -732,7 +743,7 @@
 .
 .SH
 NEWS VERSION 1.19
-.
+.LP
 .SH 2
 troff
 
@@ -1061,7 +1072,7 @@
 .
 .SH
 NEWS VERSION 1.18.1
-.
+.LP
 .SH 2
 troff
 
@@ -1173,7 +1184,7 @@
 .
 .SH
 NEWS VERSION 1.18
-
+.LP
 This section describes recent user-visible changes in groff.
 Bug fixes are not described.
 There are more details in the man pages.
@@ -1821,13 +1832,6 @@
 troff completely ignores it.
 .ULE
 .
-.HR
+.LNE
 .
-\s[-2]\f[I]This document was produced using
-.URL http://groff.ffii.org/ groff-\n[.x].\n[.y].\n[.Y] .
-.br
-The image at the top has been contributed by Imogen Mulley (born 1991),
-based on a similar picture found on the
-.URL http://www.gnu.org "GNU server" .
-.HR
 .\" EOF
Index: groff/tmac/groff_www.man
diff -u groff/tmac/groff_www.man:1.16 groff/tmac/groff_www.man:1.17
--- groff/tmac/groff_www.man:1.16       Thu May 26 21:02:01 2005
+++ groff/tmac/groff_www.man    Mon Nov 28 08:40:23 2005
@@ -97,6 +97,11 @@
        device driver
 \&.CDS code example begin
 \&.CDE code example end
+\&.ALN place links on left of
+       main text.
+\&.LNS start a new two column
+       table with links in the left.
+\&.LNE end the two column table.
 .fi
 .PP
 Output of the
@@ -479,6 +484,33 @@
 .TP
 .B ".CDE"
 End code display
+.
+.TP
+.B ".ALN [color] [percentage]"
+Place section heading links automatically to the left of the main
+text. The color argument is optional and if present indicates which
+HTML background color is to be used under the links.
+The optional percentage indicates the amount of width to devote to
+displaying the links. The default values are #eeeeee and 30
+for color and percentage width respectively.
+This macro should only be called once at the beginning of the document.
+Once this macro has been called each section heading will emit an
+HTML table consisting of the links in the left and the section text
+on the right.
+.
+.TP
+.B ".LNS"
+Start a new two column table with links in the left column.
+This can be called if the document has text before the first .SH
+and if .ALN is used. Typically this is called just before the
+first paragraph and after the main title as it indicates that
+text after this point should be positioned to the right of
+the left hand navigational links.
+.
+.TP
+.B ".LNE"
+End a two column table. This should be called at the end of the
+document if .ALN was used.
 .
 .SH SECTION HEADING LINKS
 By default
Index: groff/tmac/www.tmac
diff -u groff/tmac/www.tmac:1.43 groff/tmac/www.tmac:1.44
--- groff/tmac/www.tmac:1.43    Fri Aug 12 08:35:08 2005
+++ groff/tmac/www.tmac Mon Nov 28 08:40:23 2005
@@ -1215,6 +1215,77 @@
 .ft P
 ..
 .
+.ds www-nav-colour "#eeeeee
+.nr www-nav-width-left  30
+.nr www-nav-width-right 70
+.
+.
+.\" LNS - left navigation start
+.
+.de LNS
+.   HTML</p> "<table><tr><td valign=top width=\\n[www-nav-width-left]% 
bgcolor=""\\*[www-nav-colour]"">"
+.   LK
+.   HTML</p> "</td><td valign=top width=\\n[www-nav-width-right]%>"
+.   nr SH-open 1
+..
+.
+.\" LNE - left navigation end
+.
+.de LNE
+.   HTML</p> </td></tr></table>
+.   HR
+..
+.nr SH-open 0
+.nr needs-begin 0
+.
+.
+.de www-SH
+.   if (0\\$1 == 0) \{\
+.      if (\\n[SH-open] == 1) .LNE
+.      nr needs-begin 1
+.      @SH-old
+.   \}
+..
+.
+.de www-NH
+.   if (0\\$1 <= 1) \{\
+.      if (\\n[SH-open] == 1) .LNE
+.      nr needs-begin 1
+.      @NH-old
+.   \}
+..
+.
+.de www-LP
+.   @LP-old
+.   if (\\n[needs-begin] == 1) \{\
+.       HR
+.       LNS
+.   \}
+.   nr needs-begin 0
+..
+.
+.\"  ALN  [colour]  [left width percentage]
+.\"       turns on automatic left navigation, this macro should only be
+.\"       called once (normally at the start of the document) as it
+.\"       indicates the all top level section headings will form a
+.\"       navigation list on the left of the main text.
+.
+.de ALN
+.   if '\*(.T'html' \{\
+.      if !'\\$1'' .ds www-nav-colour \\$1
+.      if (0\\$2 > 0) \{\
+.         nr www-nav-width-left \\$2
+.         nr www-nav-width-right (100-\\$2)
+.      \}
+.      rn @SH @SH-old
+.      rn www-SH @SH
+.      rn @NH @NH-old
+.      rn www-NH @NH
+.      rn @LP @LP-old
+.      rn www-LP @LP
+.   \}
+..
+.
 .if r ps4html .nop \O[0]
 .cp \n(_C
 .