[groff] 01/01: src/preproc/grn/*: Improve the license information.

[Bernd Warken]

bwarken pushed a commit to branch master
in repository groff.

commit 62998feb4445e8f30de476a8c192df0a8c958fd7
Author: Bernd Warken <address@hidden>
Date:   Wed Sep 17 22:28:19 2014 +0200

    src/preproc/grn/*: Improve the license information.
---
 ChangeLog                    |    4 +
 src/preproc/grn/Makefile.sub |    5 +-
 src/preproc/grn/grn.man      |  330 +++++++++++++++++++++++++++++++-----------
 3 files changed, 252 insertions(+), 87 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index ee55343..b9ab59c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2014-09-17  Bernd Warken  <address@hidden>
 
+       * src/preproc/grn/*: Improve the license information.
+
+2014-09-17  Bernd Warken  <address@hidden>
+
        * src/preproc/eqn/*: Improve the license information.
 
 2014-09-17  Bernd Warken  <address@hidden>
diff --git a/src/preproc/grn/Makefile.sub b/src/preproc/grn/Makefile.sub
index 606469d..36734e0 100644
--- a/src/preproc/grn/Makefile.sub
+++ b/src/preproc/grn/Makefile.sub
@@ -2,10 +2,7 @@
 #
 # File position: <groff-source>/src/preproc/grn/Makefile.sub
 #
-# Copyright (C) 2014
-#   Free Software Foundation, Inc.
-#
-# Last update: 2 Sep 2014
+# Copyright (C) 2014  Free Software Foundation, Inc.
 #
 # This file is part of `font utf8' which is part of `groff'.
 #
diff --git a/src/preproc/grn/grn.man b/src/preproc/grn/grn.man
index 1eeff44..65110ee 100644
--- a/src/preproc/grn/grn.man
+++ b/src/preproc/grn/grn.man
@@ -1,7 +1,16 @@
 '\" t
-.ig
-Copyright (C) 2000-2004, 2006, 2009, 2014
-  Free Software Foundation, Inc.
+.TH @address@hidden @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
+.SH NAME
address@hidden@grn \- groff preprocessor for gremlin files
+.
+.
+.\" --------------------------------------------------------------------
+.\" legal terms
+.\" --------------------------------------------------------------------
+.
+.\" license
+.de co
+Copyright (C) 2000-2014  Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -19,6 +28,20 @@ translations approved by the Free Software Foundation 
instead of in
 the original English.
 ..
 .
+.\" authors
+.de au
+David Slattengren and Barry Roitblat wrote the original Berkeley
+.IR @address@hidden .
+.
+.PP
+Daniel Senderowicz and Werner Lemberg modified it for
+.IR groff .
+..
+.
+.\" --------------------------------------------------------------------
+.\" definitons
+.\" --------------------------------------------------------------------
+.
 .do nr grn_C \n[.C]
 .cp 0
 .
@@ -36,10 +59,10 @@ the original English.
 ..
 .
 .
-.TH @address@hidden @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
-.SH NAME
address@hidden@grn \- groff preprocessor for gremlin files
+.\" --------------------------------------------------------------------
 .SH SYNOPSIS
+.\" --------------------------------------------------------------------
+.
 .BR @address@hidden
 [
 .B \-Cv
@@ -56,40 +79,51 @@ the original English.
 [
 .IR file\.\.\.\&
 ]
+.
+.
+.\" --------------------------------------------------------------------
 .SH DESCRIPTION
+.\" --------------------------------------------------------------------
+.
 .I @address@hidden
 is a preprocessor for including
 .I gremlin
 pictures in
 .I groff
 input.
+.
 .I @address@hidden
-writes to standard output, processing only input lines between two that
-start with
+writes to standard output, processing only input lines between two
+that start with
 .B .GS
 and
-.BR .GE.
+.BR .GE .
+.
 Those lines must contain
 .I @address@hidden
 commands (see below).
+.
 These commands request a
 .I gremlin
-file, and the picture in that file is
-converted and placed in the
+file, and the picture in that file is converted and placed in the
 .I @address@hidden
 input stream.
+.
 The
 .B .GS
 request may be followed by a C, L, or R to center, left, or right
 justify the whole
 .I gremlin
 picture (default justification is center).
+.
 If no
 .I file
 is mentioned, the standard input is read.
+.
 At the end of the picture, the position on the page is the bottom of the
 .I gremlin
 picture.
+.
 If the
 .I @address@hidden
 entry is ended with
@@ -97,14 +131,19 @@ entry is ended with
 instead of
 .BR .GE ,
 the position is left at the top of the picture.
+.
+.
 .PP
 Please note that currently only the \-me macro package has support for
 .BR .GS ,
 .BR .GE ,
 and
 .BR .GF .
+.
+.
 .PP
 The following command-line options are understood:
+.
 .TP
 .BI \-T dev
 Prepare output for printer
@@ -114,6 +153,7 @@ The default device is
 See
 .BR groff (@MAN1EXT@)
 for acceptable devices.
+.
 .TP
 .BI \-M dir
 Prepend
@@ -121,12 +161,14 @@ Prepend
 to the default search path for
 .I gremlin
 files.
+.
 The default path is (in that order) the current directory, the home
 directory,
 .BR @SYSTEMMACRODIR@ ,
 .BR @LOCALMACRODIR@ ,
 and
 .BR @MACRODIR@ .
+.
 .TP
 .BI \-F dir
 Search
@@ -141,6 +183,7 @@ file before the default font directories
 .BR @FONTDIR@ ,
 and
 .BR @LEGACYFONTDIR@ .
+.
 .TP
 .B \-C
 Recognize
@@ -159,13 +202,21 @@ even when followed by a character other than space or 
newline.
 .\"This way, postprocessors that overwrite rather than merge picture elements
 .\"(such as Postscript) can still have text and graphics on a shaded
 .\"background.
+.
 .TP
 .B \-v
 Print the version number.
+.
+.
 .PP
 It is possible to have whitespace between a command line option and its
 parameter.
-.SH GRN COMMANDS
+.
+.
+.\" --------------------------------------------------------------------
+.SH "GRN COMMANDS"
+.\" --------------------------------------------------------------------
+.
 Each input line between
 .B .GS
 and
@@ -173,15 +224,20 @@ and
 may have one
 .I @address@hidden
 command.
+.
 Commands consist of one or two strings separated by white space, the first
 string being the command and the second its operand.
 Commands may be upper or lower case and abbreviated down to one character.
+.
+.
 .PP
-Commands that affect a picture's environment (those listed before
+Commands that affect a picture\[aq]s environment (those listed before
 .BR default ,
 see below) are only in effect for the current picture:
+.
 The environment is reinitialized to the defaults at the start of the next
 picture.
+.
 The commands are as follows:
 .TP
 .BI 1\  N
@@ -191,12 +247,15 @@ The commands are as follows:
 .BI 3\  N
 .TQ
 .BI 4\  N
+.
 Set
-.IR gremlin 's
+.IR gremlin \[aq]s
 text size number 1 (2, 3, or 4) to
 .I N
 points.
+.
 The default is 12 (16, 24, and 36, respectively).
+.
 .TP
 .BI roman\  f
 .TQ
@@ -206,32 +265,37 @@ The default is 12 (16, 24, and 36, respectively).
 .TQ
 .BI special\  f
 Set the roman (italics, bold, or special) font to
-.IR @address@hidden 's
+.IR @address@hidden \[aq]s
 font
 .I f
 (either a name or number).
+.
 The default is R (I, B, and S, respectively).
+.
 .TP
 .BI l\  f
 .TQ
 .BI stipple\  f
 Set the stipple font to
-.IR @address@hidden 's
+.IR @address@hidden \[aq]s
 stipple font
 .I f
 (name or number).
+.
 The command
 .B stipple
-may be abbreviated down as far as `st' (to avoid
-confusion with
+may be abbreviated down as far as \[oq]st\[cq] (to avoid confusion
+with
 .BR special ).
+.
 There is
 .I no
-default for stipples (unless one is set by the default command), and it is
-invalid to include a
+default for stipples (unless one is set by the default command), and
+it is invalid to include a
 .I gremlin
 picture with polygons without specifying a
 stipple font.
+.
 .TP
 .BI x\  N
 .TQ
@@ -239,28 +303,36 @@ stipple font.
 Magnify the picture (in addition to any default magnification) by
 .IR N ,
 a floating point number larger than zero.
+.
 The command
 .B scale
-may be abbreviated down to `sc'.
+may be abbreviated down to \[oq]sc\[cq].
+.
 .TP
 .BI narrow\  N
 .TQ
 .BI medium\  N
 .TQ
 .BI thick\  N
+.
 Set the thickness of
-.IR gremlin 's
+.IR gremlin \[aq]s
 narrow (medium and thick, respectively) lines to
 .I N
 times 0.15pt (this value can be changed at compile time).
+.
 The default is 1.0 (3.0 and 5.0, respectively), which corresponds to 0.15pt
 (0.45pt and 0.75pt, respectively).
+.
 A thickness value of zero selects the smallest available line thickness.
-Negative values cause the line thickness to be proportional to the current
-point size.
+.
+Negative values cause the line thickness to be proportional to the
+current point size.
+.
 .TP
 .BI pointscale\  <off/on>
 Scale text to match the picture.
+.
 Gremlin text is usually printed in the point size specified with the
 commands
 .BR 1 ,
@@ -268,46 +340,56 @@ commands
 .BR 3 ,
 .RB or\~ 4 ,
 regardless of any scaling factors in the picture.
+.
 Setting
 .B pointscale
 will cause the point sizes to scale with the picture (within
-.IR @address@hidden 's
+.IR @address@hidden \[aq]s
 limitations, of course).
+.
 An operand of anything but
 .I off
 will turn text scaling on.
+.
 .TP
 .B default
 Reset the picture environment defaults to the settings in the current
 picture.
-This is meant to be used as a global parameter setting mechanism at the
-beginning of the
+.
+This is meant to be used as a global parameter setting mechanism at
+the beginning of the
 .I @address@hidden
 input file, but can be used at any time to reset the
 default settings.
+.
 .TP
 .BI width\  N
 Forces the picture to be
 .I N
 inches wide.
+.
 This overrides any scaling factors present in the same picture.
-.RB ` width
-.IR 0 '
+.RB \[oq] width
+.IR 0 \[cq]
 is ignored.
+.
 .TP
 .BI height\  N
 Forces picture to be
 .I N
 inches high, overriding other scaling factors.
-If both `width' and `height' are specified the tighter constraint will
-determine the scale of the picture.
+.
+If both \[oq]width\[cq] and \[oq]height\[cq] are specified the tighter
+constraint will determine the scale of the picture.
 .B Height
 and
 .B width
 commands are not saved with a
 .B default
 command.
+.
 They will, however, affect point size scaling if that option is set.
+.
 .TP
 .BI file\  name
 Get picture from
@@ -317,27 +399,34 @@ file
 located the current directory (or in the library directory; see the
 .B \-M
 option above).
+.
 If two
 .B file
 commands are given, the second one overrides the first.
+.
 If
 .I name
-doesn't exist, an error message is reported and processing continues from
-the
+doesn\[aq]t exist, an error message is reported and processing
+continues from the
 .B .GE
 line.
-.SH NOTES ABOUT GROFF
+.
+.
+.\" --------------------------------------------------------------------
+.SH "NOTES ABOUT GROFF"
+.\" --------------------------------------------------------------------
+.
 Since
 .I @address@hidden
-is a preprocessor, it doesn't know about current indents, point sizes,
-margins, number registers, etc.
-Consequently, no
+is a preprocessor, it doesn\[aq]t know about current indents, point
+sizes, margins, number registers, etc.  Consequently, no
 .I @address@hidden
 input can be placed between the
 .B .GS
 and
 .B .GE
 requests.
+.
 However,
 .I gremlin
 text is now processed by
@@ -346,7 +435,8 @@ so anything valid in a single line of
 .I @address@hidden
 input is valid in a line of
 .I gremlin
-text (barring `.' directives at the beginning of a line).
+text (barring \[oq].\[cq] directives at the beginning of a line).
+.
 Thus, it is possible to have equations within a
 .I gremlin
 figure by including in the
@@ -355,6 +445,8 @@ file
 .I eqn
 expressions enclosed by previously defined delimiters (e.g.\&
 .IR $$ ).
+.
+.
 .PP
 When using
 .I @address@hidden
@@ -367,18 +459,24 @@ and/or
 .I ideal
 to avoid overworking
 .IR tbl .
+.
 .I Eqn
 should always be run last.
+.
+.
 .PP
-A picture is considered an entity, but that doesn't stop
+A picture is considered an entity, but that doesn\[aq]t stop
 .I @address@hidden
 from trying to break it up if it falls off the end of a page.
-Placing the picture between `keeps' in \-me macros will ensure proper
-placement.
+.
+Placing the picture between \[oq]keeps\[cq] in \-me macros will ensure
+proper placement.
+.
+.
 .PP
 .I @address@hidden
 uses
-.IR @address@hidden 's
+.IR @address@hidden \[aq]s
 number registers
 .B g1
 through
@@ -392,7 +490,12 @@ to the width and height of the
 figure (in device units) before entering the
 .B .GS
 request (this is for those who want to rewrite these macros).
-.SH GREMLIN FILE FORMAT
+.
+.
+.\" --------------------------------------------------------------------
+.SH "GREMLIN FILE FORMAT"
+.\" --------------------------------------------------------------------
+.
 There exist two distinct
 .I gremlin
 file formats, the original format from the
@@ -402,6 +505,7 @@ graphic terminal version, and the
 or
 .I X11
 version.
+.
 An extension to the
 .IR SUN / X11
 version allowing reference points with negative coordinates is
@@ -409,6 +513,7 @@ version allowing reference points with negative coordinates 
is
 compatible with the
 .I AED
 version.
+.
 As long as a
 .I gremlin
 file does not contain negative coordinates, either format will be read
@@ -416,10 +521,12 @@ correctly by either version of
 .I gremlin
 or
 .IR @address@hidden .
+.
 The other difference to the
 .IR SUN / X11
 format is the use of names for picture objects (e.g., POLYGON, CURVE)
 instead of numbers.
+.
 Files representing the same picture are shown in Table 1 in each format.
 .sp
 .TS
@@ -471,36 +578,50 @@ or
 is ignored by the
 .IR SUN / X11
 version.
+.
 .B 0
 means that
 .I gremlin
 will display things in horizontal format (drawing area wider than it is
 tall, with menu across top).
+.
 .B 1
 means that
 .I gremlin
-will display things in vertical format (drawing area taller than it is wide,
-with menu on left side).
+will display things in vertical format (drawing area taller than it is
+wide, with menu on left side).
+.
 .B x
 and
 .B y
-are floating point values giving a positioning point to be used when this
-file is read into another file.
-The stuff on this line really isn't all that important; a value of ``1 0.00
-0.00'' is suggested.
+are floating point values giving a positioning point to be used when
+this file is read into another file.
+.
+The stuff on this line really isn\[aq]t all that important; a value of
+\[lq]1 0.00 0.00\[rq] is suggested.
+.
 .IP \(bu
 The rest of the file consists of zero or more element specifications.
-After the last element specification is a line containing the string ``\-1''.
+.
+After the last element specification is a line containing the string
+\[lq]\-1\[rq].
+.
 .IP \(bu
 Lines longer than 127 characters are chopped to this limit.
+.
+.
+.\" --------------------------------------------------------------------
 .SH ELEMENT SPECIFICATIONS
+.\" --------------------------------------------------------------------
+.
 .IP \(bu
-The first line of each element contains a single decimal number giving the
-type of the element
+The first line of each element contains a single decimal number giving
+the type of the element
 .RI ( AED
 version) or its ASCII name
 .RI ( SUN / X11
 version).
+.
 See Table 2.
 .sp
 .TS
@@ -538,16 +659,19 @@ After the object type comes a variable number of lines, 
each specifying a
 point used to display the element.
 Each line contains an x-coordinate and a y-coordinate in floating point
 format, separated by spaces.
-The list of points is terminated by a line containing the string ``\-1.0
-\-1.0''
+The list of points is terminated by a line containing the string \[lq]\-1.0
+\-1.0\[rq]
 .RI ( AED
-version) or a single asterisk, ``*''
+version) or a single asterisk, \[lq]*\[rq]
 .RI ( SUN / X11
 version).
+.
 .IP \(bu
 After the points comes a line containing two decimal values, giving the
 brush and size for the element.
+.
 The brush determines the style in which things are drawn.
+.
 For vectors, arcs, and curves there are six valid brush values:
 .sp
 .TS
@@ -574,77 +698,117 @@ ncw(0.1i)l.
 4 \(mi@@special (S font in groff)
 .TE
 .sp
-If you're using
+If you\[aq]re using
 .I @address@hidden
 to run your pictures through
 .IR groff ,
 the font is really just a starting font:
+.
 The text string can contain formatting sequences like
-``\efI''
+\[lq]\efI\[rq]
 or
-``\ed''
+\[lq]\ed\[rq]
 which may change the font (as well as do many other things).
+.
 For text, the size field is a decimal value between 1 and 4.
+.
 It selects the size of the font in which the text will be drawn.
-For polygons, this size field is interpreted as a stipple number to fill the
-polygon with.
+.
+For polygons, this size field is interpreted as a stipple number to
+fill the polygon with.
+.
 The number is used to index into a stipple font at print time.
+.
 .IP \(bu
 The last line of each element contains a decimal number and a string of
 characters, separated by a single space.
+.
 The number is a count of the number of characters in the string.
+.
 This information is only used for text elements, and contains the text
 string.
+.
 There can be spaces inside the text.
-For arcs, curves, and vectors, this line of the element contains the string
-``0''.
-.SH NOTES ON COORDINATES
+.
+For arcs, curves, and vectors, this line of the element contains the
+string \[lq]0\[rq].
+.
+.
+.\" --------------------------------------------------------------------
+.SH "NOTES ON COORDINATES"
+.\" --------------------------------------------------------------------
+.
 .I gremlin
 was designed for
 .IR AED s,
 and its coordinates reflect the
 .I AED
 coordinate space.
-For vertical pictures, x-values range 116 to 511, and y-values from 0 to
-483.
-For horizontal pictures, x-values range from 0 to 511 and y-values range
-from 0 to 367.
-Although you needn't absolutely stick to this range, you'll get best results
-if you at least stay in this vicinity.
-Also, point lists are terminated by a point of (\-1, \-1), so you shouldn't
-ever use negative coordinates.
+.
+For vertical pictures, x-values range 116 to 511, and y-values from 0
+to 483.
+.
+For horizontal pictures, x-values range from 0 to 511 and y-values
+range from 0 to 367.
+.
+Although you needn\[aq]t absolutely stick to this range, you\[aq]\ll
+get best results if you at least stay in this vicinity.
+.
+Also, point lists are terminated by a point of (\-1, \-1), so you
+shouldn't ever use negative coordinates.
+.
 .I gremlin
-writes out coordinates using format ``%f1.2''; it's probably a good idea to
-use the same format if you want to modify the
+writes out coordinates using format \[lq]%f1.2\[rq]; it\[aq]s probably
+a good idea to use the same format if you want to modify the
 .I @address@hidden
 code.
-.SH NOTES ON SUN/X11 COORDINATES
-There is no longer a restriction on the range of coordinates used to create
-objects in the
+.
+.
+.\" --------------------------------------------------------------------
+.SH "NOTES ON SUN/X11 COORDINATES"
+.\" --------------------------------------------------------------------
+.
+There is no longer a restriction on the range of coordinates used to
+create objects in the
 .IR SUN / X11
 version of
 .IR gremlin .
+.
 However, files with negative coordinates
 .B will
 cause problems if displayed on the
 .IR AED .
+.
+.
+.\" --------------------------------------------------------------------
 .SH FILES
+.\" --------------------------------------------------------------------
+.
 .Tp \w'@FONTDIR@/devname/DESC'u+3n
 .BI @FONTDIR@/dev name /DESC
 Device description file for device
 .IR name .
+.
+.
+.\" --------------------------------------------------------------------
 .SH SEE ALSO
+.\" --------------------------------------------------------------------
+.
 .BR gremlin (1),
 .BR groff (@MAN1EXT@),
 .BR @address@hidden (@MAN1EXT@),
 .BR ideal (1)
-.SH HISTORY
-.PP
-David Slattengren and Barry Roitblat wrote the original Berkeley
-.IR @address@hidden .
-.PP
-Daniel Senderowicz and Werner Lemberg modified it for
-.IR groff .
+.
+.
+.\" --------------------------------------------------------------------
+.SH COPYING
+.\" --------------------------------------------------------------------
+.co
+.\" --------------------------------------------------------------------
+.SH AUTHORS
+.\" --------------------------------------------------------------------
+.au
+.
 .
 .cp \n[grn_C]
 .