Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

PSTools — A collection of PostScript shell tools

These are all smaller helper scripts for postscript output. In my personal editing environment, I use troff to create postscript files. Sometimes it is necessary to manually adjust the postscript file.

These tools are intentionally not the most performant. They are meant to just work. Feel free to contribute more performant versions as well as other tools.

psmove — move pages around

Use this tool to move pages around. E. g. move the last page (table of contents) to the beginning, so we have a nicely formatted document with ordered pages. All other pages are renumbered to fit the moved page.

# psmove from to < >
; psmove 6 2 < >

from must be greater than to!

psmovem — move pages around according to a map

This tool can shuffle pages at will. It needs two parameters: number of pages and a mapping table.

The mapping table is a comma separated list of page numbers.

# reorder a document with 5 pages
; psmovem 5 1,2,3,5,4 < >

psnumseq — create mapping table

This tools provides a generator for mapping tables for psmovem. It uses a simple mapping syntax similar to rc shell redirections.

# move page 5 to 2, then the last page to 1
; psnumseq '5=2' '-0=1'
# the output can be directly used with psmovem
; psmovem «numpages» `{psnumseq '5=2' '-0=1'}

Note that 0 is invalid while -0 is valid!

pspnumber — renumber pages

This tool takes postscript input and renumbers all pages sequentially. It can be used to clean up after moving pages around with psmove.

It also fixes the %%Pages: page number attribute, but only if it's set after the pages.

; pspnumber < >

Additional troff tools

Note: I currently use me macros almost exclusively. Some of these scripts might not work properly with other macro packages.

refx — double references (troff)

This troff preprocessor is able to produce double references with refer. This way you can have both footnotes and bibliography, which is not possible with the ported refer.

# refx flags
; refx <file | troff ...

refx will invoke refer two times (with and without the accumulate flag).

txt2ms — text to troff-ms preprocessor

Convert formatted text files to a troff language (-ms like).

# sample usage
; txt2ms <file.txt | troff -ms ...

The format uses the two point glyph for special parsing of bold/italic: ‥italic‥ and ‥‥bold‥‥. To disable this parsing enable the dontparse flag. Otherwise the format is markdown-like:

# sample section
## sample subsection
### sample subsubsection

New paragraph with ‥‥bold‥‥ and ‥italic‥ text.

Another paragraph with \fBbold\fR and \fIitalic\fR text.

Keep in mind that the format only borrows from markdown. Many features are not supported (links, ...).

The converter is line oriented. Therefore troff content can be included where needed. Only empty lines and lines beginning with # are converted.

One special feature: The script is able to use the first line as a title, allowing quick ms-flavored documents. To use this feature the firstheader variable needs to be set.

Set variables like this:

; txt2ms -v 'firstheader=1' 'dontparse=1' < file.txt

Using txt2ms allows the creation of tables of contents. The important lines are printed to stderr.

; txt2ms < file.txt | troff >[2] aux.file

txt2ms also introduces the .KT macro for keep titles.

.KT "index" "Prefix" "Title."

This will typeset a keep title in the form: Prefix 5: Title.

Using the *t string and number (.ds *t "text, .nr *t 10) allows setting the indentation level and a hanging tag.

lib/txtmk is an mk library file and can be used to compile indexes that can be included in the source text file (with .so file.msi). To use the lib/txtmk library you should include the global $MACROS variable in your mkfile (with contents like: -ms -mpictures).

Note: You need to filter the output if you have errors/warnings!


collection of postscript shell tools