/[groff]/groff/doc/webpage.ms
ViewVC logotype

Diff of /groff/doc/webpage.ms

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.17 by wl, Wed Nov 24 14:18:21 2004 UTC revision 1.18 by wl, Fri May 27 07:10:53 2005 UTC
# Line 120  See the file COPYING for copying permiss Line 120  See the file COPYING for copying permiss
120  The file PROBLEMS describes various problems that have been encountered in  The file PROBLEMS describes various problems that have been encountered in
121  compiling, installing, and running groff.  compiling, installing, and running groff.
122    
123  The most recent released version of groff is always available by anonymous  The most recent released version of groff is always available by
124  ftp from ftp.gnu.org in the directory pub/\:gnu/\:groff.  .URL "ftp://\:ftp.gnu.org/\:gnu/\:groff" "anonymous ftp" .
125    
126  A  The current development version of groff is available from a
127  .URL "http://\:savannah.gnu.org/\:cvs/\:?group=groff" "CVS repository"  .URL "http://\:savannah.gnu.org/\:cvs/\:?group=groff" "CVS repository" .
128  is available, containing the current development version of groff.  You can access it by first selecting a parent directory in
129  You can access it with the commands  which to create a working copy (call it, say, ~/cvswork), and then
130    executing the commands
131    
132  .in 2m  .in 2m
133  .nf  .nf
134  .ft C  .ft C
135  export CVSROOT=:ext:anoncvs@savannah.gnu.org:/cvsroot/groff  cd ~/cvswork
136  export CVS_RSH=ssh  CVS_RSH=ssh; export CVS_RSH
137  cvs -z9 co groff  cvs -d:ext:anoncvs@savannah.gnu.org/cvsroot/groff -z5 co groff
138  .ft P  .ft P
139  .fi  .fi
140  .in  .in
141    
142  Note that you need an SSH client for security reasons.      (Note that you need an SSH client for security reasons.)
143    
144  An update of a checked out repository should be done with  This will create a subdirectory, ~/cvswork/groff, with a `checked out'
145    copy of the CVS repository.
146    An update of this working copy may be
147    achieved, at any later time by invoking the commands
148    
149  .in 2m  .in 2m
150    .nf
151  .ft C  .ft C
152  CVS_RSH=ssh cvs -z9 update -dP  cd ~/cvswork/groff
153    CVS_RSH=ssh cvs -z5 update -dP
154  .ft P  .ft P
155    .fi
156  .in  .in
157    
158  Please read the info pages of cvs for further details.  Please read the CVS info pages for further details.
159    
160    Finally, it is possible to access the CVS with a
161    .URL http://\:savannah.gnu.org/\:cvs/\:?group=groff "web browser" .
162    
163  Alternatively, you can download snapshots (which are updated twice a day)  Alternatively, you can download snapshots (which are updated twice a day).
164  from  The complete groff source as a single file is available
165  .URL http://\:groff.ffii.org/\:groff/\:devel/\:groff-current.tar.gz here  .URL http://\:groff.ffii.org/\:groff/\:devel/\:groff-current.tar.gz here .
166  or a diff file relative to the latest official groff release as  
167    A diff file relative to groff-\[la]version\[ra], the latest official groff
168    release is available at
169    
170  .in 2m  .in 2m
171  .ft C  .ft C
# Line 175  gunzip -c ../groff-\[la]version\[ra]-cur Line 187  gunzip -c ../groff-\[la]version\[ra]-cur
187  .fi  .fi
188  .in  .in
189    
190  Finally, it is possible to access the CVS with a browser by pointing it  Depending on your requirements, you may need at least some of the
191  to  following tools to build groff directly from its source:
192    
193  .in 2m  .in 2m
194  .URL http://savannah.gnu.org/cvs/?group=groff \  .nf
195       http://savannah.gnu.org/cvs/?group=groff  ghostscript
196    the psutils package
197    the netpbm package
198    texinfo 4.8
199    bison \[>=] 1.875b or byacc
200    .fi
201  .in  .in
202    
203    Note that texinfo and bison or byacc are required only for building from
204    CVS sources (either a checked out working copy, or a daily snapshot).
205    They are not required for building from a stable release tarball.
206    Also note that the version numbers stated are the minimum supported.
207    No version of texinfo < 4.8 will work, and the original release of bison
208    1.875 is known not to work; you \fImay\fP find that bison releases < 1.875
209    will work, but in case of difficulty, please update to a later version
210    \fIbefore\fP posting a bug report.
211    
212    For \fIall\fP sources, you need ghostscript for creation of either PDF or
213    HTML output; the netpbm and psutils packages are required only for HTML
214    output.
215    If you don't intend to produce output in either of these formats, then
216    these packages are unnecessary.
217    
218  Please report bugs using the form in the file BUG-REPORT; the idea of this  Please report bugs using the form in the file BUG-REPORT; the idea of this
219  is to make sure that FSF has all the information it needs to fix the bug.  is to make sure that FSF has all the information it needs to fix the bug.
220  At the very least, read the BUG-REPORT form and make sure that you supply  At the very least, read the BUG-REPORT form and make sure that you supply
# Line 207  for general discussion of groff Line 239  for general discussion of groff
239  a read-only list showing commitments to the CVS repository  a read-only list showing commitments to the CVS repository
240  .ULE  .ULE
241    
242  You must be subscribed to the `groff' list to send mails.  You can post mails directly to the `bug-groff' list, without subscribing;
243    to post mails to the `groff' list you must subscribe to it.
244    
245  To subscribe, send e-mail to \[la]list\[ra]-request@\[la]domain\[ra]  To subscribe, send e-mail to \[la]list\[ra]-request@\[la]domain\[ra]
246  (example:  (example:
247  .MTO groff-request@\:gnu.org groff-request@\:gnu.org )  .MTO groff-request@\:gnu.org groff-request@\:gnu.org
248  with the word `subscribe' in either the  for the `groff' list) with the word `subscribe' in either the
249  subject or body of the e-mail (don't include the quotes) or have a look  subject or body of the e-mail (don't include the quotes).
250  at the  Alternatively, you may subscribe by visiting the web pages at
251  .URL http://\:lists.gnu.org/\:mailman/\:listinfo/\:groff/ \  
252       "groff mailing list webpage" .  .in 2m
253    .nf
254    .URL http://lists.gnu.org/mailman/listinfo/bug-groff
255    .URL http://lists.gnu.org/mailman/listinfo/groff
256    .URL http://lists.gnu.org/mailman/listinfo/groff-commit
257    .fi
258    .in
259    
260    Each of these web pages also provides a link to a browseable archive of
261    postings to the corresponding mailing list.
262    
263  GNU groff was written by  GNU groff was written by
264  .MTO jjc@\:jclark.com "James Clark" .  .MTO jjc@\:jclark.com "James Clark" .
# Line 227  and Line 269  and
269  .  .
270  .  .
271  .SH  .SH
272    NEWS VERSION 1.19.2
273    .
274    .SH 2 troff
275    
276    .ULS
277    .LI
278    Analogously to the .ft and \ef pair, two new requests `gcolor' and
279    `fcolor' (which pair with \em and \eM, respectively) have been added to
280    set the glyph and background colours.
281    
282    .LI
283    A new read-only, string-valued register `.sty' returns the name of the
284    current style.
285    
286    .LI
287    Two new conditional operators `F\~\[la]name\[ra]' and `S\~\[la]name\[ra]'
288    have been added.
289    `F' is true if a font \[la]name\[ra] exists.
290    `S' is true if a style \[la]name\[ra] has been registered.
291    
292    .LI
293    Cyrillic characters have been added to the `utf8' and `html' output
294    devices.
295    .ULE
296    .
297    .
298    .SH 2
299    pic
300    
301    .ULS
302    .LI
303    The `by' argument in a `for' loop can now be negative if it is additive.
304    For the multiplicative case, it must be greater than zero.
305    .ULE
306    .
307    .
308    .SH 2
309    eqn
310    
311    .ULS
312    .LI
313    The following keywords aren't new but haven't been documented previously:
314    
315    .in 2m
316    \fBundef NAME\fP (to undefine a macro)
317    .br
318    \fBcopy "FILE"\fP (a synonym for `include')
319    .br
320    \fBspace n\fP (to modify the vertical spacing before and after an equation)
321    .in
322    
323    .LI
324    The following macros aren't new but haven't been documented previously:
325    
326    .in 2m
327    \fBAlpha, .\|.\|., Omega\fP (the same as `ALPHA', .\|.\|., `OMEGA')
328    .br
329    \fBldots\fP (three dots on the base line)
330    .br
331    \fBdollar\fP (a dollar glyph)
332    .in
333    
334    .LI
335    The following keywords have been extended.  Again, this isn't new but
336    hasn't been documented previously:
337    
338    .in 2m
339    .ft B
340    col n { .\|.\|. }
341    .br
342    lcol n { .\|.\|. }
343    .br
344    rcol n { .\|.\|. }
345    .br
346    ccol n { .\|.\|. }
347    .br
348    pile n { .\|.\|. }
349    .br
350    lpile n { .\|.\|. }
351    .br
352    rpile n { .\|.\|. }
353    .br
354    cpile n { .\|.\|. }
355    .ft P
356    (set vertical spacing between rows to\~N)
357    .ULE
358    .
359    .
360    .SH 2
361    grohtml
362    
363    .ULS
364    .LI
365    This device driver has been raised to beta stage; its set of tags should
366    be stable now.
367    
368    .LI
369    New command line option `\-s' to set the base point size.
370    
371    .LI
372    New command line option `\-S' to set the split level while generating
373    multiple files.
374    .ULE
375    .
376    .
377    .SH 2
378    gxditview
379    
380    .ULS
381    .LI
382    On platforms which have the X\~Window System this program is now built and
383    installed automatically.
384    .ULE
385    .
386    .
387    .SH 2
388    xtotroff
389    
390    .ULS
391    .LI
392    This program to create font definition files for xditview isn't new but
393    hasn't been installed previously.
394    .ULE
395    .
396    .
397    .SH 2
398    groffer
399    
400    .ULS
401    .LI
402    A security problem (reported as CAN-2004-0969) has been fixed.
403    .ULE
404    .
405    .
406    .SH 2
407    gdiffmk
408    
409    .ULS
410    .LI
411    A new script contributed by Mike Bianchi.
412    It compares two groff, nroff, or troff documents and creates an output with
413    added margin characters (using `.mc') to indicate the differences.
414    .ULE
415    .
416    .
417    .SH 2
418    pdfroff
419    
420    .ULS
421    .LI
422    A new wrapper script contributed by Keith Marshall to easily create PDF
423    documents with groff.
424    .ULE
425    .
426    .
427    .SH 2
428    macro packages
429    
430    .ULS
431    .LI
432    ms.tmac
433    
434    .ULS
435    .LI
436    Support for fractional point sizes: A value for the `PS', `VS', `FPS',
437    and `VPS' register larger than or equal to 1000 is always divided by 1000.
438    For example, `.nr\~PS\~10250' sets the document's font size to 10.25 points.
439    
440    .LI
441    The `Ds' and `De' macros provided in ms since groff version 1.19 have
442    been removed; the equivalent `DS' and `DE' macros should be used instead.
443    X11 documents which actually use `Ds' and `De' always load a
444    specific macro file from the X11 distribution (`macros.t') which
445    provides proper definitions for the two macros.
446    
447    .LI
448    The following registers have been added for improving layout control:
449    
450    .IP PORPHANS
451    Defines number of lines following `LP', `PP', `QP', `IP' or `XP' which
452    must be kept together, before any automatic page break.
453    
454    .IP HORPHANS
455    Sets number of lines of following paragraph which must be kept with a
456    heading, defined by `NH' or `SH', before any automatic page break.
457    
458    .IP GROWPS
459    Sets the first level of heading (set with `NH') which will keep the
460    same point size as body text.
461    
462    .IP PSINCR
463    Sets the point size increment for each level of heading (set with
464    `NH'), below the threshold level set by `GROWPS'; e.g., if
465    \en[PS]\~=\~10, \en[GROWPS]\~=\~3 and \en[PSINCR]\~=\~2.0p, then `.NH\~1'
466    will produce 14pt headings, `.NH\~2' will produce 12pt, and all other levels
467    will remain at 10pt (because \en[PS]\~=\~10).
468    
469    .LI
470    The `SH' macro now accepts a numeric argument, to make heading size
471    match that of `NH' with same argument value when the `GROWPS'/`PSINCR'
472    feature is enabled.
473    .ULE
474    
475    Please refer to the documentation of the ms package for other, minor
476    improvements.
477    
478    .LI
479    me.tmac
480    
481    The section type set with the `++' request is available in the `_M'
482    register.
483    This isn't new but hasn't been documented before.
484    
485    .LI
486    www.tmac
487    
488    The `HR' macro no longer causes an empty line for non-HTML devices.
489    
490    A new macro `HEAD' has been added to directly add data to the
491    <head>...</head> block.
492    
493    New macros `OLS' and `OLE' to start and end an ordered list.
494    
495    New macros `DLS' and `DLE' to start and end a definition list.
496    .ULE
497    .
498    .
499    .SH 2
500    pdfmark
501    
502    .ULS
503    .LI
504    A new macro package contributed by Keith Marshall which implements PDF
505    marks.
506    This is in alpha stage currently.
507    .ULE
508    .
509    .
510    .SH 2
511    miscellaneous
512    
513    .ULS
514    .LI
515    Two new keywords to the DESC file have been added which are needed for
516    grohtml: `image_generator' and `unscaled_charwidths'.
517    The former gives the name of the program which creates PNG images,
518    and the latter makes troff always use unscaled character widths.
519    .ULE
520    .
521    .
522    .SH
523  NEWS VERSION 1.19.1  NEWS VERSION 1.19.1
524  .  .
525  .SH 2  .SH 2

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.18

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26