diff options
author | wl <wl> | 2007-07-05 16:00:47 +0000 |
---|---|---|
committer | wl <wl> | 2007-07-05 16:00:47 +0000 |
commit | 25706fc4059a503e136ec5c7590d2848de6b494e (patch) | |
tree | 8eecfbbb7aac45eeaf1344a1e82ee9d377815365 /contrib | |
parent | 8f07ac9b5e64660c89be016a2d68f014e1c038ff (diff) | |
download | groff-25706fc4059a503e136ec5c7590d2848de6b494e.tar.gz |
DOS -> Unix line endings
Diffstat (limited to 'contrib')
-rw-r--r-- | contrib/hdtbl/README | 174 |
1 files changed, 87 insertions, 87 deletions
diff --git a/contrib/hdtbl/README b/contrib/hdtbl/README index 394ef3c5..e495f536 100644 --- a/contrib/hdtbl/README +++ b/contrib/hdtbl/README @@ -1,87 +1,87 @@ -This is Version 0.91 of hdtbl
-============================
-
-Content:
---------
-
- hdtbl.tmac Definition of the 4 base and three optional
- hdtbl-macros.
- Definition of internal utility macros.
- Default settings for macro arguments.
-
- hdmisc.tmac Some macros from the hdgroff system internally
- used bei hdtbl.
- Some further hdgroff macros for the examples.
-
- groff_hdtbl.7 The hdtbl manpage.
- groff_hdtbl.7.txt raw text manpage.
- groff_hdtbl.7.ps PostScript formatted manpage.
- groff_hdtbl.7.pdf PDF-formatted manpage.
- groff_hdtbl.7.html HTML-formatted manpage.
-
- examples directory with 3 subdirectories:
-
- hdtblgroff: some hdtbl examples
-
- hdtblps: PS-formatted hdtbl examples
-
- hdtblpdf: PDF-formatted hdtbl examples
-
-Preparing the use of hdtbl:
----------------------------
-
-For an easy use of the hdtbl macros you can copy the macro files
-`hdtbl.tmac´ and `hdmisc.tmac´ in the directory `site-tmac´ of groff,
-typical in `/usr/share/groff´ or `/usr/local/share/groff´.
-A place for the man page `groff_hdtbl.7´ could be `/usr/man/man7´,
-`/usr/share/man/man7´ or `/usr/local/man/man7´.
-
-Now you can call `groff -m hdtbl ...´ and `man groff_hdtbl´.
-If you don't have access to the `site-tmac´ directory you can put
-`hdtbl.tmac´ and `hdmisc.tmac´ into a private macro directory `xyz´
-and reference this with the aditional flag `-`M xyz´ when calling groff.
-
-If you like to use hdtbl in conjunction with another macro package,
-e.g. ms, say `groff -m ms ...´ and in your document `.mso hdtbl.tmac´.
-To get the behaviour, that a table, which does not fit on a partially
-filled page, will be printed automatically on the top of the next page
-you must append the little hdtbl utility macro `t*hm´to the page header
-macro of the other macro package, e.g. for the ms macros:
-
- .am pg@top \" the ms pageheader macro
- .t*hm
- ..
-
-hdtbl has builtin pageheader- and pagebottom makros HM and BM. If they
-interfere with your own, replace them with `.rm HM´ and `.rm BM´.
-
-You can change the default settings for hdtbl and the builtin pageheader
-and -bottom macros by overwriting the corresponding registers and strings
-at the beginning of file `hdtbl.tmac´.
-
-HDtbl is clean groff, but some of the examples and additional macros
-in `hdmisc.tmac´ necessary for some examples use system requests via
-`.sy´ and `.pso´. This requires a) to call groff with the `-U´ flag and
-b) to provide for Windows an Unix environment like Cygwin or MinGW.
-
-To Do:
-------
-
-* Macro TOTC (Table Of Table Captions).
-
-* Automatic recognition of the number of columns.
-
-* Optional automatic calculation of the cellwidths from the widths of
- the first line of the cellcontent instead of the explicit
- specification with the width argument. This seems to be nontrivial
- without a preprocessor or additional external calls vial .sy or .pso.
-
-* Handling of pagebreaks in tables.
-
-* Floating text left and/or right from tables.
-
-* Converter hdtbl2html (awk, elisp, perl?); should be easy to write.
-
-* Support for nroff.
-
-Enjoy with hdtbl!
\ No newline at end of file +This is Version 0.91 of hdtbl +============================ + +Content: +-------- + + hdtbl.tmac Definition of the 4 base and three optional + hdtbl-macros. + Definition of internal utility macros. + Default settings for macro arguments. + + hdmisc.tmac Some macros from the hdgroff system internally + used bei hdtbl. + Some further hdgroff macros for the examples. + + groff_hdtbl.7 The hdtbl manpage. + groff_hdtbl.7.txt raw text manpage. + groff_hdtbl.7.ps PostScript formatted manpage. + groff_hdtbl.7.pdf PDF-formatted manpage. + groff_hdtbl.7.html HTML-formatted manpage. + + examples directory with 3 subdirectories: + + hdtblgroff: some hdtbl examples + + hdtblps: PS-formatted hdtbl examples + + hdtblpdf: PDF-formatted hdtbl examples + +Preparing the use of hdtbl: +--------------------------- + +For an easy use of the hdtbl macros you can copy the macro files +`hdtbl.tmac´ and `hdmisc.tmac´ in the directory `site-tmac´ of groff, +typical in `/usr/share/groff´ or `/usr/local/share/groff´. +A place for the man page `groff_hdtbl.7´ could be `/usr/man/man7´, +`/usr/share/man/man7´ or `/usr/local/man/man7´. + +Now you can call `groff -m hdtbl ...´ and `man groff_hdtbl´. +If you don't have access to the `site-tmac´ directory you can put +`hdtbl.tmac´ and `hdmisc.tmac´ into a private macro directory `xyz´ +and reference this with the aditional flag `-`M xyz´ when calling groff. + +If you like to use hdtbl in conjunction with another macro package, +e.g. ms, say `groff -m ms ...´ and in your document `.mso hdtbl.tmac´. +To get the behaviour, that a table, which does not fit on a partially +filled page, will be printed automatically on the top of the next page +you must append the little hdtbl utility macro `t*hm´to the page header +macro of the other macro package, e.g. for the ms macros: + + .am pg@top \" the ms pageheader macro + .t*hm + .. + +hdtbl has builtin pageheader- and pagebottom makros HM and BM. If they +interfere with your own, replace them with `.rm HM´ and `.rm BM´. + +You can change the default settings for hdtbl and the builtin pageheader +and -bottom macros by overwriting the corresponding registers and strings +at the beginning of file `hdtbl.tmac´. + +HDtbl is clean groff, but some of the examples and additional macros +in `hdmisc.tmac´ necessary for some examples use system requests via +`.sy´ and `.pso´. This requires a) to call groff with the `-U´ flag and +b) to provide for Windows an Unix environment like Cygwin or MinGW. + +To Do: +------ + +* Macro TOTC (Table Of Table Captions). + +* Automatic recognition of the number of columns. + +* Optional automatic calculation of the cellwidths from the widths of + the first line of the cellcontent instead of the explicit + specification with the width argument. This seems to be nontrivial + without a preprocessor or additional external calls vial .sy or .pso. + +* Handling of pagebreaks in tables. + +* Floating text left and/or right from tables. + +* Converter hdtbl2html (awk, elisp, perl?); should be easy to write. + +* Support for nroff. + +Enjoy with hdtbl! |