* tmac/ptx.tmac: New file.

* NEWS, man/groff_tmac: man: Document it.

4 files changed, 67 insertions, 5 deletions

diff --git a/ChangeLog b/ChangeLog
index 8b2b9a68..36047f16 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2009-01-02  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/ptx.tmac: New file.
+
+	* NEWS, man/groff_tmac: man: Document it.
+
 2008-12-30  Werner LEMBERG  <wl@gnu.org>
 
 	Fix more quoting issues.
@@ -163,7 +169,7 @@
 	Tadziu Hoffmann.  It can now process multiple man pages with both
 	man and mdoc formats intermixed.
 
-	* NEWS, tmaca/groff_man.man, tmac/groff_mdoc.man,
+	* NEWS, tmac/groff_man.man, tmac/groff_mdoc.man,
 	man/groff_tmac.man: Document it.
 
 2008-10-04  Werner LEMBERG  <wl@gnu.org>
@@ -8093,7 +8099,7 @@ Version 1.19 released
 
 	* REVISION: Increased to 2.
 
-Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008
+Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
   Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
diff --git a/NEWS b/NEWS
index c9b582c2..29b7577f 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,5 @@
-    Copyright (C) 1989-2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
+    Copyright (C) 1989-2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
+                  2009
       Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
@@ -234,6 +235,9 @@ o For -ms, Eric S. Raymond contributed support for ancient Bell Labs
 o A new string, `SN-STYLE', has been added to the ms macros, controlling
   the formatting of section numbers in headings defined by `.NH'.
 
+o The new macro package `ptx' provides a template definition for the `.xx'
+  macro as needed by GNU ptx (for creating permuted indices).
+
 
 VERSION 1.19.2
 ==============
diff --git a/man/groff_tmac.man b/man/groff_tmac.man
index c2ef5d56..9b22ca1d 100644
--- a/man/groff_tmac.man
+++ b/man/groff_tmac.man
@@ -5,7 +5,7 @@ File position: <groff-source>/man/groff_tmac.man
 
 This file is part of groff, the GNU roff type-setting system.
 
-Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007, 2008
+Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007, 2008, 2009
   Free Software Foundation, Inc.
 written by Bernd Warken <bwarken@mayn.de> and Werner Lemberg
 <wl@gnu.org>
@@ -477,6 +477,18 @@ covers the image's width.
 .
 .
 .TP
+.B ptx
+A single macro is provided in this file,
+.BR xx ,
+for formatting permuted index entries as produces by the GNU
+.BR ptx (1)
+program.
+.
+In case you need a different formatting, copy the macro into
+your document and adapt it to your needs.
+.
+.
+.TP
 .B trace
 Use this for tracing macro calls.
 .
@@ -1185,7 +1197,7 @@ See the previous section for a detailed description.
 .SH AUTHOR
 .\" --------------------------------------------------------------------
 .
-Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007, 2008
+Copyright (C) 2000, 2001, 2002, 2003, 2004, 2006, 2007, 2008, 2009
 Free Software Foundation, Inc.
 .
 .P
diff --git a/tmac/ptx.tmac b/tmac/ptx.tmac
new file mode 100644
index 00000000..f8d4da39
--- /dev/null
+++ b/tmac/ptx.tmac
@@ -0,0 +1,40 @@
+.\" ptx.tmac
+.\"
+.\"   Provide `.xx' macro to format permuted index entries as created
+.\"   by GNU ptx.
+.\"
+.\" Written 2008 by Werner Lemberg (wl@gnu.org)
+.\"
+.\" Public domain.
+.
+.nr ptx-ref-pos (\n[.l] - .65i)
+.nr ptx-head-pos (\n[ptx-ref-pos] / 2)
+.
+.ds ptx-sep-2 "   \"
+.ds ptx-sep-4 " \"
+.ds ptx-sep-5 " \"
+.
+.
+.de xx
+.  ds ptx-sep-1
+.  if \w\\$2 \
+.    ds ptx-sep-1 " \|\"
+.
+.  ds ptx-sep-3
+.  if \w\\$4 \
+.    ds ptx-sep-3 " \|\"
+.
+.  ds ptx-filler \\*[ptx-sep-4]\f3\a\fP\\*[ptx-sep-5]
+.  ta (\\n[ptx-ref-pos]u - \w\\*[ptx-sep-5]u)
+.
+\h(\\n[ptx-head-pos]u - \w\\$1\\*[ptx-sep-1]\\$2\\*[ptx-sep-2]u)\
+\\$1\\*[ptx-sep-1]\
+\\$2\\*[ptx-sep-2]\
+\\$3\\*[ptx-sep-3]\
+\\$4\\*[ptx-filler]\
+\\$5
+..
+.
+.nf
+.
+.\" eof