[Groff-commit] groff/contrib/hdtbl ChangeLog groff_hdtbl.man T...

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     09/01/02 23:11:01

Modified files:
        contrib/hdtbl  : ChangeLog groff_hdtbl.man 
Added files:
        contrib/hdtbl  : TODO 
Removed files:
        contrib/hdtbl  : README 

Log message:
        * README: Renamed to...
        * TODO: This, removing most of its contents.
        
        * groff_hdtbl.man: Add customization info which was in file README.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/hdtbl/ChangeLog?cvsroot=groff&r1=1.26&r2=1.27
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/hdtbl/groff_hdtbl.man?cvsroot=groff&r1=1.7&r2=1.8
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/hdtbl/TODO?cvsroot=groff&rev=1.1
http://cvs.savannah.gnu.org/viewcvs/groff/contrib/hdtbl/README?cvsroot=groff&r1=1.3&r2=0

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/contrib/hdtbl/ChangeLog,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- ChangeLog   4 Jan 2008 15:14:47 -0000       1.26
+++ ChangeLog   2 Jan 2009 23:10:57 -0000       1.27
@@ -1,3 +1,10 @@
+2009-01-03  Werner LEMBERG  <address@hidden>
+
+       * README: Renamed to...
+       * TODO: This, removing most of its contents.
+
+       * groff_hdtbl.man: Add customization info which was in file README.
+
 2008-01-04  Werner LEMBERG  <address@hidden>
 
        * groff_hdtbl.man: Replace .MTO with .MT/.ME.
@@ -189,7 +196,7 @@
        * Import of hdtbl 0.91 (with some further modifications).  Still
        many rough edges.
 
-Copyright 2006, 2008
+Copyright 2006, 2008, 2009
   Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,

Index: groff_hdtbl.man
===================================================================
RCS file: /cvsroot/groff/groff/contrib/hdtbl/groff_hdtbl.man,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- groff_hdtbl.man     4 Jan 2008 15:14:47 -0000       1.7
+++ groff_hdtbl.man     2 Jan 2009 23:11:00 -0000       1.8
@@ -1,5 +1,5 @@
 .ig
-Copyright (C) 2005, 2006, 2008
+Copyright (C) 2005, 2006, 2008, 2009
   Free Software Foundation, Inc.
 
 Written by Joachim Walsdorff <address@hidden>
@@ -895,6 +895,43 @@
 .XDEFS vl=s t*vl
 .
 .
+.SH HDTBL CUSTOMIZATION
+.
+A table which does not fit on a partially filled page is printed
+automatically on the top of the next page if you append the little
+utility macro
+.CR t*hm
+to the page header macro of your document's main macro package.
+For example, say
+.
+.PP
+.RS
+.nf
+.CR ".am address@hidden"
+.CR ".  t*hm"
+.CR ".."
+.fi
+.RE
+.
+.PP
+if you use the
+.B ms
+macro package.
+.
+.PP
+.B hdtbl
+has built-in page header and page footer macros,
+.B HM
+and
+.BR BM .
+If they interfere with your own header and footer macros, simply
+say
+.CR ".rm\ HM"
+and
+.CR ".rm\ BM"
+to remove them.
+.
+.
 .SH AUTHOR
 .
 .MT address@hidden

Index: TODO
===================================================================
RCS file: TODO
diff -N TODO
--- /dev/null   1 Jan 1970 00:00:00 -0000
+++ TODO        2 Jan 2009 23:11:00 -0000       1.1
@@ -0,0 +1,21 @@
+TODO
+----
+
+* Macro TOTC (Table Of Table Captions).
+
+* Automatic recognition of the number of columns.
+
+* Optional automatic calculation of the cell widths from the widths of the
+  first line of the cell content instead of the explicit specification with
+  the width argument.  This seems to be non-trivial without a preprocessor
+  or additional external calls via .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.
+
+* Support for -Thtml.

Index: README
===================================================================
RCS file: README
diff -N README
--- README      18 Aug 2007 07:06:54 -0000      1.3
+++ /dev/null   1 Jan 1970 00:00:00 -0000
@@ -1,94 +0,0 @@
-    Copyright (C) 2005, 2006
-      Free Software Foundation, Inc.
-
-    Copying and distribution of this file, with or without modification,
-    are permitted in any medium without royalty provided the copyright
-    notice and this notice are preserved.
-
-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 address@hidden \"   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!