summaryrefslogtreecommitdiff
path: root/tmac/groff_www.man
diff options
context:
space:
mode:
authorwlemb <wlemb>2003-07-07 07:37:33 +0000
committerwlemb <wlemb>2003-07-07 07:37:33 +0000
commitf011af41ce79eb34a7bba5097f4754caa4ab54ac (patch)
treeeaad8d7a2d42bd32cc0ce83d18d311c3da1c22dd /tmac/groff_www.man
parent68b7d33189b177dac5a8cc0755dde75c3514bbbc (diff)
downloadgroff-f011af41ce79eb34a7bba5097f4754caa4ab54ac.tar.gz
Make grotty work on platforms which have unsigned char as the
default for char. Based on a patch by Thomas Klausner <wiz@netbsd.org>. * src/devices/grotty/tty.cpp (schar): New typedef. Updated calls to declare_ptable and implement_ptable. (glyph): Use schar for back_color_idx and fore_color_idx. (tty_printer): Use schar for curr_fore_idx and curr_back_idx. (tty_printer::tty_color, tty_printer::tty_printer, tty_printer::color_to_idx, tty_printer::put_color): Updated. * src/roff/nroff/nroff.sh: Add option -d for completeness. * src/roff/nroff/nroff.man: Updated. * NEWS, tmac/groff_www.man: Updated. * doc/Makefile.sub: Updated. Implement support for multiple HTML output files. * src/preproc/html/pre-html.cpp (scanArguments): Dummy handling for -j command line option. * src/devices/grohtml/post-html.cpp (job_name, multiple_files): New global variables. (file): New fields `new_output_file', `require_links', `output_file_name'. (file::file): Updated. (files::set_file_name, files::set_links_required, files::are_links_required, files::is_new_output_file, files::file_name, files::next_file_name): New functions. (header_desc): New fields `no_of_level_one_headings', `header_filename'. (header_desc::header_desc): Updated. (header_desc::write_headings): Handle multiple files. (html_printer::write_header): Save file name in which header occurs. (html_printer::determine_header_level): Possibly split files on level one headings. (html_printer::do_links, html_printer::troff_tag): Updated. (html_printer::insert_split_file, html_printer::do_job_name, html_printer::emit_link, html_printer::write_navigation, html_printer::do_file_components): New functions. (html_printer::~html_printer): Handle multiple files. (main): Handle command line option `-j'. * src/devices/grohtml/grohtml.man: Updated. * doc/Makefile.sub (pic.html), doc/Makefile.in (pic.html): New rule which splits file. * tmac/www.tmac (JOBNAME): New macro. * tmac/s.tmac (SH-NO-TAG): New macro. (@SH): Call SH-NO-TAG. (@NH): Updated.
Diffstat (limited to 'tmac/groff_www.man')
-rw-r--r--tmac/groff_www.man29
1 files changed, 19 insertions, 10 deletions
diff --git a/tmac/groff_www.man b/tmac/groff_www.man
index d659777d..b1f1c5dd 100644
--- a/tmac/groff_www.man
+++ b/tmac/groff_www.man
@@ -1,5 +1,5 @@
.TH GROFF_WWW @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
-.\" Copyright (C) 2000, 2001, 2002 Free Software Foundation, Inc.
+.\" Copyright (C) 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
.\" Written by Gaius Mulley (gaius@glam.ac.uk)
.\"
.\" This file is part of groff.
@@ -42,7 +42,7 @@ file ...
This manual page describes the GNU \-mwww macro package, which is part of
the groff document formatting system.
The manual page is very a basic guide, and the html device driver
-.RB ( grohtml )
+.RB ( \%grohtml )
has been completely rewritten but still remains as in an alpha state.
It has been included into the distribution so that a lot of people have a
chance to test it.
@@ -52,12 +52,13 @@ file) if you use
.BR \-Thtml .
.PP
To see the hyperlinks in action, please format this man page with the
-.B grohtml
+.B \%grohtml
device.
.PP
Here is a summary of the functions found in this macro set.
.ta 2iL
.nf
+\&.JOBNAME split output into multiple files
\&.HX automatic heading level cut off;
$1 point for sections/headers
\&.BCL specify colours on a web page
@@ -96,10 +97,18 @@ preprocessors is acceptable as input.
.
.SH REQUESTS
.TP
+.B JOBNAME
+Split output into multiple files.
+Its argument is the file stem name for future output files.
+This option is equivalent to
+.BR \%grohtml 's
+.B \-j
+option.
+.TP
.B HX
Specify the cut off depth when generating links from section headings.
For example, a parameter of\~2 would cause
-.B grohtml
+.B \%grohtml
to generate a list of links for
.B .NH\ 1
and
@@ -115,7 +124,7 @@ Whereas
.RE
.IP
will tell
-.B grohtml
+.B \%grohtml
that no heading links should be created at all.
Another method for turning automatic headings off is by issuing the
the command line switch
@@ -313,7 +322,7 @@ End heading.
.TP
.B LK
.TAG LK
-Force grohtml to place the automatically generated links at this position.
+Force \%grohtml to place the automatically generated links at this position.
If this manual page has been processed with
.B \-Thtml
those links can be seen right here.
@@ -323,7 +332,7 @@ those links can be seen right here.
.
.SH SECTION HEADING LINKS
By default
-.B grohtml
+.B \%grohtml
generates links to all section headings and places these at the top of the
html document. (See
.URL #LK LINKS
@@ -335,7 +344,7 @@ Generate a full-width horizontal rule.
.
.TP
.B NHR
-Suppress generation of the top and bottom rules which grohtml emits
+Suppress generation of the top and bottom rules which \%grohtml emits
by default.
.
.TP
@@ -394,12 +403,12 @@ information is currently rendered as a PNG image.
.SH "SEE ALSO"
.BR groff (@MAN1EXT@),
.BR @g@troff (@MAN1EXT@)
-.BR grohtml (@MAN1EXT@),
+.BR \%grohtml (@MAN1EXT@),
.BR netpbm (1)
.
.
.SH AUTHOR
-.B grohtml
+.B \%grohtml
was written by
.MTO gaius@glam.ac.uk "Gaius Mulley"
.