diff options
author | Masayuki Hatta (mhatta) <mhatta@debian.org> | 2008-01-03 06:38:51 -0800 |
---|---|---|
committer | Masayuki Hatta (mhatta) <mhatta@debian.org> | 2008-01-03 06:38:51 -0800 |
commit | 081c86fbe0ad77d4b596bc1c0e593a3def8a8051 (patch) | |
tree | 48c16557869e78ef16a5d9ed080c53cc14f8059a /man |
Import a2ps_4.14.orig.tar.gz
[dgit import orig a2ps_4.14.orig.tar.gz]
Diffstat (limited to 'man')
-rw-r--r-- | man/GNUmakefile | 27 | ||||
-rw-r--r-- | man/Makefile.am | 16 | ||||
-rw-r--r-- | man/Makefile.in | 484 | ||||
-rw-r--r-- | man/Makefile.maint | 29 | ||||
-rw-r--r-- | man/a2ps.1 | 292 | ||||
-rw-r--r-- | man/a2ps.x | 5 | ||||
-rw-r--r-- | man/card.1 | 62 | ||||
-rw-r--r-- | man/card.x | 5 | ||||
-rw-r--r-- | man/common.x | 7 | ||||
-rw-r--r-- | man/fixps.1 | 78 | ||||
-rw-r--r-- | man/fixps.x | 5 | ||||
-rwxr-xr-x | man/help2man | 510 | ||||
-rw-r--r-- | man/pdiff.1 | 64 | ||||
-rw-r--r-- | man/pdiff.x | 5 | ||||
-rw-r--r-- | man/psmandup.1 | 78 | ||||
-rw-r--r-- | man/psmandup.x | 5 | ||||
-rw-r--r-- | man/psset.1 | 84 | ||||
-rw-r--r-- | man/psset.x | 5 | ||||
-rw-r--r-- | man/texi2dvi4a2ps.1 | 101 | ||||
-rw-r--r-- | man/texi2dvi4a2ps.x | 9 |
20 files changed, 1871 insertions, 0 deletions
diff --git a/man/GNUmakefile b/man/GNUmakefile new file mode 100644 index 0000000..96aa665 --- /dev/null +++ b/man/GNUmakefile @@ -0,0 +1,27 @@ +# Having a separate GNUmakefile lets me use features of GNU make +# to generate the man pages. +# This makefile is used only if you run GNU Make. +# It is necessary if you want to build targets usually of interest +# only to the maintainer. + +# Systems where /bin/sh is not the default shell need this. The $(shell) +# command below won't work with e.g. stock DOS/Windows shells. +SHELL = /bin/sh + +have-Makefile := $(shell test -f Makefile && echo yes) + +# If the user runs GNU make but has not yet run ./configure, +# give them a diagnostic. +ifeq ($(have-Makefile),yes) + +include Makefile +include $(srcdir)/Makefile.maint + +else + +all: + @echo There seems to be no Makefile in this directory. + @echo "You must run ./configure before running \`make'." + @exit 1 + +endif diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 0000000..9d79cc8 --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,16 @@ +## Process this file with automake to produce Makefile.in -*-Makefile-*- +man_MANS = a2ps.1 card.1 fixps.1 pdiff.1 psmandup.1 psset.1 texi2dvi4a2ps.1 +man_aux = $(man_MANS:.1=.x) + +irregular_men = a2ps.1 texi2dvi4a2ps.1 +a2ps.1 : $(top_srcdir)/src/main.c +texi2dvi4a2ps.1: $(top_srcdir)/contrib/texi2dvi4a2ps + +EXTRA_DIST = $(man_MANS) $(HELP2MAN) $(man_aux) \ + Makefile.maint GNUmakefile common.x +PERL = @PERL@ +HELP2MAN = help2man +MAINTAINERCLEANFILES = $(man_MANS) + +# For additional rules usually of interest only to the maintainer, +# see GNUmakefile and Makefile.maint. diff --git a/man/Makefile.in b/man/Makefile.in new file mode 100644 index 0000000..7376a84 --- /dev/null +++ b/man/Makefile.in @@ -0,0 +1,484 @@ +# Makefile.in generated by automake 1.9.6 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +top_builddir = .. +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +INSTALL = @INSTALL@ +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = man +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/a2_psutils.m4 \ + $(top_srcdir)/m4/atexit.m4 $(top_srcdir)/m4/file.m4 \ + $(top_srcdir)/m4/fp_echo.m4 $(top_srcdir)/m4/fullpath.m4 \ + $(top_srcdir)/m4/gccwarn.m4 $(top_srcdir)/m4/gettext.m4 \ + $(top_srcdir)/m4/gperf-check.m4 $(top_srcdir)/m4/iconv.m4 \ + $(top_srcdir)/m4/inttypes_h.m4 $(top_srcdir)/m4/isc-posix.m4 \ + $(top_srcdir)/m4/lex.m4 $(top_srcdir)/m4/lib-ld.m4 \ + $(top_srcdir)/m4/lib-link.m4 $(top_srcdir)/m4/lib-prefix.m4 \ + $(top_srcdir)/m4/libpaper.m4 $(top_srcdir)/m4/lpr.m4 \ + $(top_srcdir)/m4/m4.m4 $(top_srcdir)/m4/malloc.m4 \ + $(top_srcdir)/m4/mbrtowc.m4 $(top_srcdir)/m4/mbstate_t.m4 \ + $(top_srcdir)/m4/perl.m4 $(top_srcdir)/m4/prereq.m4 \ + $(top_srcdir)/m4/progtest.m4 $(top_srcdir)/m4/protos.m4 \ + $(top_srcdir)/m4/realloc.m4 $(top_srcdir)/m4/rename.m4 \ + $(top_srcdir)/m4/stdint_h.m4 $(top_srcdir)/m4/strcasecmp.m4 \ + $(top_srcdir)/m4/strftim.m4 $(top_srcdir)/m4/termios.m4 \ + $(top_srcdir)/m4/tterm.m4 $(top_srcdir)/m4/uintmax_t.m4 \ + $(top_srcdir)/m4/ulonglong.m4 $(top_srcdir)/m4/winsz.m4 \ + $(top_srcdir)/m4/xstrtoumax.m4 $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/auxdir/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +man1dir = $(mandir)/man1 +am__installdirs = "$(DESTDIR)$(man1dir)" +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +ALLOCA = @ALLOCA@ +AMDEP_FALSE = @AMDEP_FALSE@ +AMDEP_TRUE = @AMDEP_TRUE@ +AMTAR = @AMTAR@ +AR = @AR@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +COM_DISPLAY = @COM_DISPLAY@ +COM_LATEX = @COM_LATEX@ +COM_PS2PDF = @COM_PS2PDF@ +COM_PSUTILS = @COM_PSUTILS@ +COM_TEXI = @COM_TEXI@ +COM_acroread = @COM_acroread@ +COM_acroread4 = @COM_acroread4@ +COM_bzip = @COM_bzip@ +COM_bzip2 = @COM_bzip2@ +COM_convert = @COM_convert@ +COM_distill = @COM_distill@ +COM_dvips = @COM_dvips@ +COM_ghostview = @COM_ghostview@ +COM_grog = @COM_grog@ +COM_gv = @COM_gv@ +COM_gzip = @COM_gzip@ +COM_html2ps = @COM_html2ps@ +COM_latex = @COM_latex@ +COM_makeinfo = @COM_makeinfo@ +COM_netscape = @COM_netscape@ +COM_pdf2ps = @COM_pdf2ps@ +COM_ps2pdf = @COM_ps2pdf@ +COM_psnup = @COM_psnup@ +COM_psselect = @COM_psselect@ +COM_tex = @COM_tex@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CXX = @CXX@ +CXXCPP = @CXXCPP@ +CXXDEPMODE = @CXXDEPMODE@ +CXXFLAGS = @CXXFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +ECHO = @ECHO@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EMACS = @EMACS@ +EMACSLOADPATH = @EMACSLOADPATH@ +ENCODING = @ENCODING@ +EXEEXT = @EXEEXT@ +EXTENSIONS_FALSE = @EXTENSIONS_FALSE@ +EXTENSIONS_TRUE = @EXTENSIONS_TRUE@ +EXTRA_CFLAGS = @EXTRA_CFLAGS@ +F77 = @F77@ +FFLAGS = @FFLAGS@ +FILE_LINK = @FILE_LINK@ +GMSGFMT = @GMSGFMT@ +GNU_PACKAGE = @GNU_PACKAGE@ +GPERF = @GPERF@ +GREP = @GREP@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INTLLIBS = @INTLLIBS@ +LDFLAGS = @LDFLAGS@ +LEX = @LEX@ +LEXLIB = @LEXLIB@ +LEX_OUTPUT_ROOT = @LEX_OUTPUT_ROOT@ +LIBICONV = @LIBICONV@ +LIBINTL = @LIBINTL@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIBVERSION = @LIBVERSION@ +LN_S = @LN_S@ +LPR = @LPR@ +LPR_QUEUE_OPTION = @LPR_QUEUE_OPTION@ +LTALLOCA = @LTALLOCA@ +LTLIBICONV = @LTLIBICONV@ +LTLIBINTL = @LTLIBINTL@ +LTLIBOBJS = @LTLIBOBJS@ +M4 = @M4@ +MAKEINFO = @MAKEINFO@ +MEDIUM = @MEDIUM@ +MKINSTALLDIRS = @MKINSTALLDIRS@ +MSGFMT = @MSGFMT@ +MSGMERGE = @MSGMERGE@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +POSUB = @POSUB@ +PSFONT_PATH = @PSFONT_PATH@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +U = @U@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +YACC = @YACC@ +YFLAGS = @YFLAGS@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_CXX = @ac_ct_CXX@ +ac_ct_F77 = @ac_ct_F77@ +acroread = @acroread@ +am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ +am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ +am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@ +am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +bzip = @bzip@ +bzip2 = @bzip2@ +convert = @convert@ +datadir = @datadir@ +datarootdir = @datarootdir@ +distill = @distill@ +docdir = @docdir@ +dvidir = @dvidir@ +dvips = @dvips@ +exec_prefix = @exec_prefix@ +file_prog = @file_prog@ +ghostview = @ghostview@ +grog = @grog@ +gv = @gv@ +gzip = @gzip@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +html2ps = @html2ps@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +latex = @latex@ +libdir = @libdir@ +libexecdir = @libexecdir@ +lispdir = @lispdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +makeinfo = @makeinfo@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +netscape = @netscape@ +oldincludedir = @oldincludedir@ +pdf2ps = @pdf2ps@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +ps2pdf = @ps2pdf@ +psdir = @psdir@ +psnup = @psnup@ +psselect = @psselect@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +subdirs = @subdirs@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +tex = @tex@ +man_MANS = a2ps.1 card.1 fixps.1 pdiff.1 psmandup.1 psset.1 texi2dvi4a2ps.1 +man_aux = $(man_MANS:.1=.x) +irregular_men = a2ps.1 texi2dvi4a2ps.1 +EXTRA_DIST = $(man_MANS) $(HELP2MAN) $(man_aux) \ + Makefile.maint GNUmakefile common.x + +HELP2MAN = help2man +MAINTAINERCLEANFILES = $(man_MANS) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +distclean-libtool: + -rm -f libtool +uninstall-info-am: +install-man1: $(man1_MANS) $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man1dir)" || $(mkdir_p) "$(DESTDIR)$(man1dir)" + @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ + l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ + for i in $$l2; do \ + case "$$i" in \ + *.1*) list="$$list $$i" ;; \ + esac; \ + done; \ + for i in $$list; do \ + if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ + else file=$$i; fi; \ + ext=`echo $$i | sed -e 's/^.*\\.//'`; \ + case "$$ext" in \ + 1*) ;; \ + *) ext='1' ;; \ + esac; \ + inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ + inst=`echo $$inst | sed -e 's/^.*\///'`; \ + inst=`echo $$inst | sed '$(transform)'`.$$ext; \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst"; \ + done +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ + l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ + for i in $$l2; do \ + case "$$i" in \ + *.1*) list="$$list $$i" ;; \ + esac; \ + done; \ + for i in $$list; do \ + ext=`echo $$i | sed -e 's/^.*\\.//'`; \ + case "$$ext" in \ + 1*) ;; \ + *) ext='1' ;; \ + esac; \ + inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ + inst=`echo $$inst | sed -e 's/^.*\///'`; \ + inst=`echo $$inst | sed '$(transform)'`.$$ext; \ + echo " rm -f '$(DESTDIR)$(man1dir)/$$inst'"; \ + rm -f "$(DESTDIR)$(man1dir)/$$inst"; \ + done +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ + list='$(DISTFILES)'; for file in $$list; do \ + case $$file in \ + $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ + $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ + esac; \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test "$$dir" != "$$file" && test "$$dir" != "."; then \ + dir="/$$dir"; \ + $(mkdir_p) "$(distdir)$$dir"; \ + else \ + dir=''; \ + fi; \ + if test -d $$d/$$file; then \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(MANS) +installdirs: + for dir in "$(DESTDIR)$(man1dir)"; do \ + test -z "$$dir" || $(mkdir_p) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." + -test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES) +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-libtool + +dvi: dvi-am + +dvi-am: + +html: html-am + +info: info-am + +info-am: + +install-data-am: install-man + +install-exec-am: + +install-info: install-info-am + +install-man: install-man1 + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-info-am uninstall-man + +uninstall-man: uninstall-man1 + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + distclean distclean-generic distclean-libtool distdir dvi \ + dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-exec install-exec-am \ + install-info install-info-am install-man install-man1 \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ + uninstall uninstall-am uninstall-info-am uninstall-man \ + uninstall-man1 + +a2ps.1 : $(top_srcdir)/src/main.c +texi2dvi4a2ps.1: $(top_srcdir)/contrib/texi2dvi4a2ps + +# For additional rules usually of interest only to the maintainer, +# see GNUmakefile and Makefile.maint. +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/man/Makefile.maint b/man/Makefile.maint new file mode 100644 index 0000000..c38b54c --- /dev/null +++ b/man/Makefile.maint @@ -0,0 +1,29 @@ +# This -*- Makefile -*- uses features of GNU make. +# It is included via GNUmakefile. + +HELP2MAN-run = $(PERL) -w -- $(srcdir)/$(HELP2MAN) + +# Depend on configure.in to get version number changes. +$(man_MANS): $(top_srcdir)/configure.in common.x + +# Depend on the source file containing the --help text. +# Filter out irregular cases. +regular_men = $(filter-out $(irregular_men),$(man_MANS)) +$(regular_men): %.1: $(top_srcdir)/contrib/%.in + +executable = $(wildcard $(top_builddir)/*/$(basename $@)) +$(man_MANS): %.1: %.x $(HELP2MAN) + @if test -f $(executable); then \ + echo "Updating man page $@"; \ + rm -f $@-t; \ + $(HELP2MAN-run) \ + --include=$(basename $@).x \ + --include=common.x \ + $(executable) > $@-t || exit 1; \ + chmod -w $@-t || exit 1; \ + rm -f $@ || exit 1; \ + mv $@-t $@ || exit 1; \ + else \ + echo "WARNING: The man page $@ cannot be updated yet."; \ + echo " Retry once the corresponding executable is built."; \ + fi diff --git a/man/a2ps.1 b/man/a2ps.1 new file mode 100644 index 0000000..9533ffa --- /dev/null +++ b/man/a2ps.1 @@ -0,0 +1,292 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH A2PS "1" "December 2007" "GNU a2ps 4.14" FSF +.SH NAME +a2ps \- format files for printing on a PostScript printer +.SH SYNOPSIS +.B a2ps +[\fIOPTION\fR]... [\fIFILE\fR]... +.SH DESCRIPTION +." Add any additional description here +.PP +Convert FILE(s) or standard input to PostScript. By default, the output +is sent to the default printer. An output file may be specified with \fB\-o\fR. +.PP +Mandatory arguments to long options are mandatory for short options too. +Long options marked with * require a yes/no argument, corresponding +short options stand for `yes'. +.SS "Tasks:" +.TP +\fB\-\-version\fR +display version +.TP +\fB\-\-help\fR +display this help +.TP +\fB\-\-guess\fR +report guessed types of FILES +.TP +\fB\-\-which\fR +report the full path of library files named FILES +.TP +\fB\-\-glob\fR +report the full path of library files matching FILES +.TP +\fB\-\-list\fR=\fIdefaults\fR +display default settings and parameters +.TP +\fB\-\-list\fR=\fITOPIC\fR +detailed list on TOPIC (delegations, encodings, features, +variables, media, ppd, printers, prologues, style-sheets, +user-options) +.PP +After having performed the task, exit successfully. Detailed lists may +provide additional help on specific features. +.SS "Global:" +.TP +\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR +be really quiet +.TP +\fB\-v\fR, \fB\-\-verbose\fR[=\fILEVEL\fR] +set verbosity on, or to LEVEL +.TP +\fB\-=\fR, \fB\-\-user\-option\fR=\fIOPTION\fR +use the user defined shortcut OPTION +.TP +\fB\-\-debug\fR +enable debugging features +.TP +\fB\-D\fR, \fB\-\-define\fR=\fIKEY[\fR:VALUE] +unset variable KEY or set to VALUE +.SS "Sheets:" +.TP +\fB\-M\fR, \fB\-\-medium\fR=\fINAME\fR +use output medium NAME +.TP +\fB\-r\fR, \fB\-\-landscape\fR +print in landscape mode +.TP +\fB\-R\fR, \fB\-\-portrait\fR +print in portrait mode +.TP +\fB\-\-columns\fR=\fINUM\fR +number of columns per sheet +.TP +\fB\-\-rows\fR=\fINUM\fR +number of rows per sheet +.TP +\fB\-\-major\fR=\fIDIRECTION\fR +first fill (DIRECTION=) rows, or columns +.TP +\fB\-1\fR, \fB\-2\fR, ..., \fB\-9\fR +predefined font sizes and layouts for 1.. 9 virtuals +.TP +\fB\-A\fR, \fB\-\-file\-align\fR=\fIMODE\fR +align separate files according to MODE (fill, rank +page, sheet, or a number) +.TP +\fB\-j\fR, \fB\-\-borders\fR* +print borders around columns +.TP +\fB\-\-margin\fR[=\fINUM\fR] +define an interior margin of size NUM +.PP +The options \fB\-1\fR.. \fB\-9\fR affect several primitive parameters to set up predefined +layouts with 80 columns. Therefore the order matters: `-R \fB\-f40\fR \fB\-2\fR' is +equivalent to `-2'. To modify the layout, use `-2Rf40', or compose primitive +options (`--columns', `--font-size' etc.). +.SS "Virtual pages:" +.TP +\fB\-\-line\-numbers\fR=\fINUM\fR +precede each NUM lines with its line number +.TP +\fB\-C\fR +alias for \fB\-\-line\-numbers\fR=\fI5\fR +.TP +\fB\-f\fR, \fB\-\-font\-size\fR=\fISIZE\fR +use font SIZE (float) for the body text +.TP +\fB\-L\fR, \fB\-\-lines\-per\-page\fR=\fINUM\fR +scale the font to print NUM lines per virtual +.TP +\fB\-l\fR, \fB\-\-chars\-per\-line\fR=\fINUM\fR +scale the font to print NUM columns per virtual +.TP +\fB\-m\fR, \fB\-\-catman\fR +process FILE as a man page (same as \fB\-L66\fR) +.TP +\fB\-T\fR, \fB\-\-tabsize\fR=\fINUM\fR +set tabulator size to NUM +.HP +\fB\-\-non\-printable\-format\fR=\fIFMT\fR specify how non-printable chars are printed +.SS "Headings:" +.TP +\fB\-B\fR, \fB\-\-no\-header\fR +no page headers at all +.TP +\fB\-b\fR, \fB\-\-header\fR[=\fITEXT\fR] +set page header +.TP +\fB\-u\fR, \fB\-\-underlay\fR[=\fITEXT\fR] +print TEXT under every page +.TP +\fB\-\-center\-title\fR[=\fITEXT\fR] +set page title to TITLE +.TP +\fB\-\-left\-title\fR[=\fITEXT\fR] +set left and right page title to TEXT +.HP +\fB\-\-right\-title\fR[=\fITEXT\fR] +.TP +\fB\-\-left\-footer\fR[=\fITEXT\fR] +set sheet footers to TEXT +.HP +\fB\-\-footer\fR[=\fITEXT\fR] +.HP +\fB\-\-right\-footer\fR[=\fITEXT\fR] +.PP +The TEXTs may use special escapes. +.SS "Input:" +.TP +\fB\-a\fR, \fB\-\-pages\fR[=\fIRANGE\fR] +select the pages to print +.TP +\fB\-c\fR, \fB\-\-truncate\-lines\fR* +cut long lines +.TP +\fB\-i\fR, \fB\-\-interpret\fR* +interpret tab, bs and ff chars +.TP +\fB\-\-end\-of\-line\fR=\fITYPE\fR +specify the eol char (TYPE: r, n, nr, rn, any) +.TP +\fB\-X\fR, \fB\-\-encoding\fR=\fINAME\fR +use input encoding NAME +.TP +\fB\-t\fR, \fB\-\-title\fR=\fINAME\fR +set the name of the job +.TP +\fB\-\-stdin\fR=\fINAME\fR +set the name of the input file stdin +.TP +\fB\-\-print\-anyway\fR* +force binary printing +.TP +\fB\-Z\fR, \fB\-\-delegate\fR* +delegate files to another application +.TP +\fB\-\-toc\fR[=\fITEXT\fR] +generate a table of content +.PP +When delegations are enabled, a2ps may use other applications to handle the +processing of files that should not be printed as raw information, e.g., HTML +PostScript, PDF etc. +.SS "Pretty-printing:" +.TP +\fB\-E\fR, \fB\-\-pretty\-print\fR[=\fILANG\fR] +enable pretty-printing (set style to LANG) +.TP +\fB\-\-highlight\-level\fR=\fILEVEL\fR +set pretty printing highlight LEVEL +LEVEL can be none, normal or heavy +.TP +\fB\-g\fR +alias for \fB\-\-highlight\-level\fR=\fIheavy\fR +.TP +\fB\-\-strip\-level\fR=\fINUM\fR +level of comments stripping +.SS "Output:" +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR +leave output to file FILE. If FILE is `-', +leave output to stdout. +.TP +\fB\-\-version\-control\fR=\fIWORD\fR +override the usual version control +.TP +\fB\-\-suffix\fR=\fISUFFIX\fR +override the usual backup suffix +.TP +\fB\-P\fR, \fB\-\-printer\fR=\fINAME\fR +send output to printer NAME +.TP +\fB\-d\fR +send output to the default printer +(this is the default behavior) +.SS "PostScript:" +.TP +\fB\-\-prologue\fR=\fIFILE\fR +include FILE.pro as PostScript prologue +.TP +\fB\-\-ppd\fR[=\fIKEY\fR] +automatic PPD selection or set to KEY +.TP +\fB\-n\fR, \fB\-\-copies\fR=\fINUM\fR +print NUM copies of each page +.TP +\fB\-s\fR, \fB\-\-sides\fR=\fIMODE\fR +set the duplex MODE (`1' or `simplex', +`2' or `duplex', `tumble') +.TP +\fB\-S\fR, \fB\-\-setpagedevice\fR=\fIK[\fR:V] +pass a page device definition to output +.TP +\fB\-\-statusdict\fR=\fIK[\fR:[:]V] +pass a statusdict definition to the output +.TP +\fB\-k\fR, \fB\-\-page\-prefeed\fR +enable page prefeed +.TP +\fB\-K\fR, \fB\-\-no\-page\-prefeed\fR +disable page prefeed +.PP +By default a2ps is tuned to do what you want to, so trust it. To pretty +print the content of the `src' directory and a table of content, and send the +result to the printer `lw', +.IP +\f(CW$ a2ps -P lw --toc src/*\fR +.PP +To process the files `sample.ps' and `sample.html' and display the result, +.IP +\f(CW$ a2ps -P display sample.ps sample.html\fR +.PP +To process a mailbox in 4 up, +.IP +\f(CW$ a2ps -=mail -4 mailbox\fR +.PP +To print as a booklet on the default printer, which is Duplex capable, +.IP +\f(CW$ a2ps -=book paper.dvi.gz -d\fR +.PP +News, updates and documentation: visit http://www.gnu.org/software/a2ps/. +.SH AUTHOR +Written by Akim Demaille, Miguel Santana. +.SH "REPORTING BUGS" +Report bugs to <bug-a2ps@gnu.org>. +.SH COPYRIGHT +Copyright \(co 1988-1993 Miguel Santana +.br +Copyright \(co 1995-2000 Akim Demaille, Miguel Santana +.br +Copyright \(co 2007- Akim Demaille, Miguel Santana and Masayuki Hatta +.br +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B a2ps +is maintained as a Texinfo manual. If the +.B info +and +.B a2ps +programs are properly installed at your site, the command +.IP +.B info a2ps +.PP +should give you access to the complete manual. diff --git a/man/a2ps.x b/man/a2ps.x new file mode 100644 index 0000000..f46b6a3 --- /dev/null +++ b/man/a2ps.x @@ -0,0 +1,5 @@ +[NAME] +a2ps \- format files for printing on a PostScript printer + +[DESCRIPTION] +." Add any additional description here diff --git a/man/card.1 b/man/card.1 new file mode 100644 index 0000000..e4c9227 --- /dev/null +++ b/man/card.1 @@ -0,0 +1,62 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH CARD "1" "December 2007" "card 1.3 (GNU a2ps 4.14)" FSF +.SH NAME +card \- print reference card of program options +.SH SYNOPSIS +.B card +[\fIOPTION\fR]... \fIPROGRAM\fR... +.SH DESCRIPTION +." Add any additional description here +.PP +Print a reference card of the PROGRAMs thanks to their inline help. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR +save the output in FILE +.TP +\fB\-l\fR, \fB\-\-language\fR=\fILL\fR +print the help in the language LL (default: English) +.TP +\fB\-\-command\fR=\fICMD\fR +perform pretty-printing on the output of CMD +(e.g. \fB\-\-command=\fR'netscape \fB\-help\fR') +.PP +Options for a2ps are given after `--', for instance +.IP +\f(CW$ card -lfr a2ps -- -Pdisplay -4\fR +.PP +News, updates and documentation: http://www.inf.enst.fr/~demaille/a2ps/ +.SH AUTHOR +Written by Akim Demaille. +.SH "REPORTING BUGS" +Report bugs to <bug-a2ps@gnu.org>. +.SH COPYRIGHT +Copyright \(co 1997-99 Akim Demaille, Miguel Santana +.br +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B card +is maintained as a Texinfo manual. If the +.B info +and +.B card +programs are properly installed at your site, the command +.IP +.B info card +.PP +should give you access to the complete manual. diff --git a/man/card.x b/man/card.x new file mode 100644 index 0000000..78ebb19 --- /dev/null +++ b/man/card.x @@ -0,0 +1,5 @@ +[NAME] +card \- print reference card of program options + +[DESCRIPTION] +." Add any additional description here diff --git a/man/common.x b/man/common.x new file mode 100644 index 0000000..4db17c0 --- /dev/null +++ b/man/common.x @@ -0,0 +1,7 @@ +[see also] +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). diff --git a/man/fixps.1 b/man/fixps.1 new file mode 100644 index 0000000..d84519e --- /dev/null +++ b/man/fixps.1 @@ -0,0 +1,78 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH FIXPS "1" "December 2007" "fixps 1.5 (GNU a2ps 4.14)" FSF +.SH NAME +fixps \- sanitize PostScript files +.SH SYNOPSIS +.B fixps +[\fIOPTIONS\fR] \fIFILE\fR +.SH DESCRIPTION +." Add any additional description here +.PP +Try to fix common PostScript problems that break postprocessing. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit +.TP +\fB\-q\fR, \fB\-\-quiet\fR +don't print informational messages +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR +save result in FILE. If FILE is `-', send to stdout +.TP +\fB\-f\fR, \fB\-\-force\fR +force full rewrite by ghostscript +.TP +\fB\-n\fR, \fB\-\-no\-fix\fR +don't fix the FILE, but still honor `-o' +.TP +\fB\-c\fR, \fB\-\-check\fR, \fB\-\-dry\-run\fR +don't perform any action +.SS "Fixes:" +.IP +- Remove junk before and after PostScript content +- Use only Unix end of lines (\en) +- Remove empty lines +- Fix Apple prologue (fixmacps) +- Fix FrameMaker prologue (fixfmps) +- Fix CorelDraw prologue (fixnt) +- Fix Windows NT 3.5/4.0 prologue (fixnt) +- Fix Windows 95 prologue +- Ensure there is a `%%BeginSetup/%%EndSetup' section +- Removes Canvas' extraneaous `%%EndDocument:' comments +- Split too long lines +.PP +If the FILE seems really in a bad state, ghostscript may be used to perform +a full rewrite. The output might then be significantly bigger, but much +safer. +.SH AUTHOR +Written by Akim Demaille. +.SH "REPORTING BUGS" +Report bugs to <bug-a2ps@gnu.org> +.SH COPYRIGHT +Copyright \(co 1998-2000 Akim Demaille, Miguel Santana +.br +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B fixps +is maintained as a Texinfo manual. If the +.B info +and +.B fixps +programs are properly installed at your site, the command +.IP +.B info fixps +.PP +should give you access to the complete manual. diff --git a/man/fixps.x b/man/fixps.x new file mode 100644 index 0000000..8f16a3d --- /dev/null +++ b/man/fixps.x @@ -0,0 +1,5 @@ +[NAME] +fixps \- sanitize PostScript files + +[DESCRIPTION] +." Add any additional description here diff --git a/man/help2man b/man/help2man new file mode 100755 index 0000000..992e44f --- /dev/null +++ b/man/help2man @@ -0,0 +1,510 @@ +#!/sw/tools/bin/perl -w + +# Generate a short man page from --help and --version output. +# Copyright © 1997, 98, 99 Free Software Foundation, Inc. + +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3, or (at your option) +# any later version. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. + +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software Foundation, +# Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + +# Written by Brendan O'Dea <bod@compusol.com.au> +# Available from ftp://ftp.gnu.org/gnu/help2man/ + +use 5.004; +use strict; +use Getopt::Long; +use Text::Tabs qw(expand); +use POSIX qw(strftime setlocale LC_TIME); + +my $this_program = 'help2man'; +my $this_version = '1.019'; +my $version_info = <<EOT; +$this_program $this_version + +Copyright (C) 1997, 98, 99 Free Software Foundation, Inc. +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +Written by Brendan O'Dea <bod\@compusol.com.au> +EOT + +my $help_info = <<EOT; +`$this_program' generates a man page out of `--help' and `--version' output. + +Usage: $this_program [OPTION]... EXECUTABLE + + -n, --name=STRING use `STRING' as the description for the NAME paragraph + -s, --section=SECTION use `SECTION' as the section for the man page + -i, --include=FILE include material from `FILE' + -I, --opt-include=FILE include material from `FILE' if it exists + -o, --output=FILE send output to `FILE' + -N, --no-info suppress pointer to Texinfo manual + --help print this help, then exit + --version print version number, then exit + +EXECUTABLE should accept `--help' and `--version' options. +EOT + +my $section = 1; +my ($opt_name, @opt_include, $opt_output, $opt_no_info); + +# Parse options. +Getopt::Long::config('bundling'); +GetOptions ( + 'n|name=s' => \$opt_name, + 's|section=s' => \$section, + 'i|include=s' => sub { push @opt_include, [ pop, 1 ] }, + 'I|opt-include=s' => sub { push @opt_include, [ pop, 0 ] }, + 'o|output=s' => \$opt_output, + 'N|no-info' => \$opt_no_info, + help => sub { print $help_info; exit }, + version => sub { print $version_info; exit }, +) or die $help_info; + +die $help_info unless @ARGV == 1; + +my %include = (); +my %append = (); +my @include = (); # retain order given in include file + +# Provide replacement `quote-regex' operator for pre-5.005. +BEGIN { eval q(sub qr { '' =~ $_[0]; $_[0] }) if $] < 5.005 } + +# Process include file (if given). Format is: +# +# [section name] +# verbatim text +# +# or +# +# /pattern/ +# verbatim text +# + +for (@opt_include) +{ + my ($inc, $required) = @$_; + + next unless -f $inc or $required; + die "$this_program: can't open `$inc' ($!)\n" + unless open INC, $inc; + + my $key; + my $hash = \%include; + + while (<INC>) + { + # [section] + if (/^\[([^]]+)\]/) + { + $key = uc $1; + $key =~ s/^\s+//; + $key =~ s/\s+$//; + $hash = \%include; + push @include, $key unless $include{$key}; + next; + } + + # /pattern/ + if (m!^/(.*)/([ims]*)!) + { + my $pat = $2 ? "(?$2)$1" : $1; + + # Check pattern. + eval { $key = qr($pat) }; + if ($@) + { + $@ =~ s/ at .*? line \d.*//; + die "$inc:$.:$@"; + } + + $hash = \%append; + next; + } + + # Silently ignore anything before the first + # section--allows for comments and revision info. + next unless $key; + + $hash->{$key} ||= ''; + $hash->{$key} .= $_; + } + + close INC; + + die "$this_program: no valid information found in `$inc'\n" + unless $key; +} + +# Compress trailing blank lines. +for my $hash (\(%include, %append)) +{ + for (keys %$hash) { $hash->{$_} =~ s/\n+$/\n/ } +} + +# Turn off localisation of executable's ouput. +@ENV{qw(LANGUAGE LANG LC_ALL)} = ('C') x 3; + +# Turn off localisation of date (for strftime). +setlocale LC_TIME, 'C'; + +# Grab help and version info from executable. +my ($help_text, $version_text) = map { + join '', map { s/ +$//; expand $_ } `$ARGV[0] --$_ 2>/dev/null` + or die "$this_program: can't get `--$_' info from $ARGV[0]\n" +} qw(help version); + +my $date = strftime "%B %Y", localtime; +(my $program = $ARGV[0]) =~ s!.*/!!; +my $package = $program; +my $version; + +if ($opt_output) +{ + unlink $opt_output + or die "$this_program: can't unlink $opt_output ($!)\n" + if -e $opt_output; + + open STDOUT, ">$opt_output" + or die "$this_program: can't create $opt_output ($!)\n"; +} + +# The first line of the --version information is assumed to be in one +# of the following formats: +# +# <version> +# <program> <version> +# {GNU,Free} <program> <version> +# <program> ({GNU,Free} <package>) <version> +# <program> - {GNU,Free} <package> <version> +# +# and seperated from any copyright/author details by a blank line. + +($_, $version_text) = split /\n+/, $version_text, 2; + +if (/^(\S+) +\(((?:GNU|Free) +[^)]+)\) +(.*)/ or + /^(\S+) +- *((?:GNU|Free) +\S+) +(.*)/) +{ + $program = $1; + $package = $2; + $version = $3; +} +elsif (/^((?:GNU|Free) +)?(\S+) +(.*)/) +{ + $program = $2; + $package = $1 ? "$1$2" : $2; + $version = $3; +} +else +{ + $version = $_; +} + +$program =~ s!.*/!!; + +# No info for `info' itself. +$opt_no_info = 1 if $program eq 'info'; + +# --name overrides --include contents. +$include{NAME} = "$program \\- $opt_name\n" if $opt_name; + +# Default (useless) NAME paragraph. +$include{NAME} ||= "$program \\- manual page for $program $version\n"; + +# Man pages traditionally have the page title in caps. +my $PROGRAM = uc $program; + +# Extract usage clause(s) [if any] for SYNOPSIS. +if ($help_text =~ s/^Usage:( +(\S+))(.*)((?:\n(?: {6}\1| *or: +\S).*)*)//m) +{ + my @syn = $2 . $3; + + if ($_ = $4) + { + s/^\n//; + for (split /\n/) { s/^ *(or: +)?//; push @syn, $_ } + } + + my $synopsis = ''; + for (@syn) + { + $synopsis .= ".br\n" if $synopsis; + s/(\S+) *//; + $synopsis .= ".B $1\n"; + s/\s+$//; + s/(([][]|\.\.+)+)/\\fR$1\\fI/g; + s/^/\\fI/ unless s/^\\fR//; + $_ .= '\fR'; + s/(\\fI)( *)/$2$1/g; + s/\\fI\\fR//g; + s/^\\fR//; + s/\\fI$//; + s/^\./\\&./; + + $synopsis .= "$_\n"; + } + + $include{SYNOPSIS} ||= $synopsis; +} + +# Process text, initial section is DESCRIPTION. +my $sect = 'DESCRIPTION'; +$_ = "$help_text\n\n$version_text"; + +# Normalise paragraph breaks. +s/^\n+//; +s/\n*$/\n/; +s/\n\n+/\n\n/g; + +# Temporarily exchange leading dots and backslashes for tokens. +s/^\./\x80/mg; +s/\\/\x81/g; + +# Start a new paragraph (if required) for these. +s/([^\n])\n(Report +bugs|Email +bug +reports +to|Written +by)/$1\n\n$2/g; + +sub convert_option; + +while (length) +{ + # Convert some standard paragraph names. + if (s/^(Options|Examples): *\n//) + { + $sect = uc $1; + next; + } + + # Copyright section + if (/^Copyright +[(\xa9]/) + { + $sect = 'COPYRIGHT'; + $include{$sect} ||= ''; + $include{$sect} .= ".PP\n" if $include{$sect}; + + my $copy; + ($copy, $_) = split /\n\n/, $_, 2; + + for ($copy) + { + # Add back newline + s/\n*$/\n/; + + # Convert iso9959-1 copyright symbol or (c) to nroff + # character. + s/^Copyright +(?:\xa9|\([Cc]\))/Copyright \\(co/mg; + + # Insert line breaks before additional copyright messages + # and the disclaimer. + s/(.)\n(Copyright |This +is +free +software)/$1\n.br\n$2/g; + + # Join hyphenated lines. + s/([A-Za-z])-\n */$1/g; + } + + $include{$sect} .= $copy; + $_ ||= ''; + next; + } + + # Catch bug report text. + if (/^(Report +bugs|Email +bug +reports +to) /) + { + $sect = 'REPORTING BUGS'; + } + + # Author section. + elsif (/^Written +by/) + { + $sect = 'AUTHOR'; + } + + # Examples, indicated by an indented leading $, % or > are + # rendered in a constant width font. + if (/^( +)([\$\%>] )\S/) + { + my $indent = $1; + my $prefix = $2; + my $break = '.IP'; + $include{$sect} ||= ''; + while (s/^$indent\Q$prefix\E(\S.*)\n*//) + { + $include{$sect} .= "$break\n\\f(CW$prefix$1\\fR\n"; + $break = '.br'; + } + + next; + } + + my $matched = ''; + $include{$sect} ||= ''; + + # Sub-sections have a trailing colon and the second line indented. + if (s/^(\S.*:) *\n / /) + { + $matched .= $& if %append; + $include{$sect} .= qq(.SS "$1"\n); + } + + my $indent = 0; + my $content = ''; + + # Option with description. + if (s/^( {1,10}([+-]\S.*?))(?:( +)|\n( {20,}))(\S.*)\n//) + { + $matched .= $& if %append; + $indent = length ($4 || "$1$3"); + $content = ".TP\n\x82$2\n\x82$5\n"; + unless ($4) + { + # Indent may be different on second line. + $indent = length $& if /^ {20,}/; + } + } + + # Option without description. + elsif (s/^ {1,10}([+-]\S.*)\n//) + { + $matched .= $& if %append; + $content = ".HP\n\x82$1\n"; + $indent = 80; # not continued + } + + # Indented paragraph with tag. + elsif (s/^( +(\S.*?) +)(\S.*)\n//) + { + $matched .= $& if %append; + $indent = length $1; + $content = ".TP\n\x82$2\n\x82$3\n"; + } + + # Indented paragraph. + elsif (s/^( +)(\S.*)\n//) + { + $matched .= $& if %append; + $indent = length $1; + $content = ".IP\n\x82$2\n"; + } + + # Left justified paragraph. + else + { + s/(.*)\n//; + $matched .= $& if %append; + $content = ".PP\n" if $include{$sect}; + $content .= "$1\n"; + } + + # Append continuations. + while (s/^ {$indent}(\S.*)\n//) + { + $matched .= $& if %append; + $content .= "\x82$1\n" + } + + # Move to next paragraph. + s/^\n+//; + + for ($content) + { + # Leading dot protection. + s/\x82\./\x80/g; + s/\x82//g; + + # Convert options. + s/(^| )(-[][\w=-]+)/$1 . convert_option $2/mge; + } + + # Check if matched paragraph contains /pat/. + if (%append) + { + for my $pat (keys %append) + { + if ($matched =~ $pat) + { + $content .= ".PP\n" unless $append{$pat} =~ /^\./; + $content .= $append{$pat}; + } + } + } + + $include{$sect} .= $content; +} + +# Refer to the real documentation. +unless ($opt_no_info) +{ + $sect = 'SEE ALSO'; + $include{$sect} ||= ''; + $include{$sect} .= ".PP\n" if $include{$sect}; + $include{$sect} .= <<EOT; +The full documentation for +.B $program +is maintained as a Texinfo manual. If the +.B info +and +.B $program +programs are properly installed at your site, the command +.IP +.B info $program +.PP +should give you access to the complete manual. +EOT +} + +# Output header. +print <<EOT; +.\\" DO NOT MODIFY THIS FILE! It was generated by $this_program $this_version. +.TH $PROGRAM "$section" "$date" "$package $version" FSF +EOT + +# Section ordering. +my @pre = qw(NAME SYNOPSIS DESCRIPTION OPTIONS EXAMPLES); +my @post = ('AUTHOR', 'REPORTING BUGS', 'COPYRIGHT', 'SEE ALSO'); +my $filter = join '|', @pre, @post; + +# Output content. +for (@pre, (grep ! /^($filter)$/o, @include), @post) +{ + if ($include{$_}) + { + my $quote = /\W/ ? '"' : ''; + print ".SH $quote$_$quote\n"; + + for ($include{$_}) + { + # Replace leading dot an backslash tokens. + s/\x80/\\&./g; + s/\x81/\\e/g; + print; + } + } +} + +exit; + +# Convert option dashes to \- to stop nroff from hyphenating 'em, and +# embolden. Option arguments get italicised. +sub convert_option +{ + local $_ = '\fB' . shift; + + s/-/\\-/g; + unless (s/\[=(.*)\]$/\\fR[=\\fI$1\\fR]/) + { + s/=(.)/\\fR=\\fI$1/; + s/ (.)/ \\fI$1/; + $_ .= '\fR'; + } + + $_; +} diff --git a/man/pdiff.1 b/man/pdiff.1 new file mode 100644 index 0000000..9b3d91e --- /dev/null +++ b/man/pdiff.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH PDIFF "1" "December 2007" "pdiff 0.4 (GNU a2ps 4.14)" FSF +.SH NAME +pdiff \- produce a pretty comparison between files +.SH SYNOPSIS +.B pdiff +\fIFILE1 FILE2 \fR[\fI-- A2PS-OPTIONS\fR...] +.SH DESCRIPTION +." Add any additional description here +.PP +Pretty print the differences between FILE1 and FILE2. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit +.TP +\fB\-q\fR, \fB\-\-quiet\fR +don't print informational messages +.TP +\fB\-l\fR, \fB\-\-lines\fR +search for line differences (`diff') +.TP +\fB\-w\fR, \fB\-\-words\fR +search for word differences (`wdiff') +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR +save the output in FILE +.PP +Options for a2ps are given after `--', for instance +.IP +\f(CW$ pdiff COPYING COPYING.LIB -- -Pdisplay\fR +.PP +News, updates and documentation: http://www.inf.enst.fr/~demaille/a2ps/. +.SH AUTHOR +Written by Akim Demaille. +.SH "REPORTING BUGS" +Report bugs to <bug-a2ps@gnu.org>. +.SH COPYRIGHT +Copyright \(co 1997-1999 Akim Demaille, Miguel Santana +.br +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B pdiff +is maintained as a Texinfo manual. If the +.B info +and +.B pdiff +programs are properly installed at your site, the command +.IP +.B info pdiff +.PP +should give you access to the complete manual. diff --git a/man/pdiff.x b/man/pdiff.x new file mode 100644 index 0000000..74b827f --- /dev/null +++ b/man/pdiff.x @@ -0,0 +1,5 @@ +[NAME] +pdiff \- produce a pretty comparison between files + +[DESCRIPTION] +." Add any additional description here diff --git a/man/psmandup.1 b/man/psmandup.1 new file mode 100644 index 0000000..11b1e72 --- /dev/null +++ b/man/psmandup.1 @@ -0,0 +1,78 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH PSMANDUP "1" "December 2007" "psmandup 2.1 (GNU a2ps 4.14)" FSF +.SH NAME +psmandup \- print duplex on non duplex printers +.SH SYNOPSIS +.B psmandup +\fIFILE\fR +.SH DESCRIPTION +." Add any additional description here +.PP +Tries to produce a version of the PostScript FILE to print in manual +Duplex. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit +.TP +\fB\-q\fR, \fB\-\-quiet\fR +don't print informational messages +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR +save result in FILE. If FILE is `-', send to stdout +.TP +\fB\-n\fR, \fB\-\-no\-fix\fR +don't call fixps to fix PS problems in FILE +.TP +\fB\-f\fR, \fB\-\-front\fR +output only the front pages (recto) on the regular +tray +.TP +\fB\-b\fR, \fB\-\-back\fR +output only the back pages (verso) on the manual +feed tray +.PP +Produced output is meant for PS level 2 printers which don't support +Duplex printing, but support Manual Feed. Once the first set of pages +is printed (odd pages), manual feed is asked: introduce the odd pages +to print the even pages on the other side. +.PP +Because there is usually a short time out for manually fed jobs, you +should really be next to the printer. If ever the time out expired, +use the option \fB\-b\fR to send only the missing part. +.PP +Environment variables FIXPS, PSSELECT and PSSET, if defined, are used +to find the tools. +.PP +News, updates and documentation: http://www.inf.enst.fr/~demaille/a2ps/ +.SH AUTHOR +Written by Akim Demaille. +.SH "REPORTING BUGS" +Report bugs to <bug-a2ps@gnu.org> +.SH COPYRIGHT +Copyright \(co 1998-1999 Akim Demaille, Miguel Santana +.br +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B psmandup +is maintained as a Texinfo manual. If the +.B info +and +.B psmandup +programs are properly installed at your site, the command +.IP +.B info psmandup +.PP +should give you access to the complete manual. diff --git a/man/psmandup.x b/man/psmandup.x new file mode 100644 index 0000000..2c98d6f --- /dev/null +++ b/man/psmandup.x @@ -0,0 +1,5 @@ +[NAME] +psmandup \- print duplex on non duplex printers + +[DESCRIPTION] +." Add any additional description here diff --git a/man/psset.1 b/man/psset.1 new file mode 100644 index 0000000..43035a5 --- /dev/null +++ b/man/psset.1 @@ -0,0 +1,84 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH PSSET "1" "December 2007" "psset 1.3 (GNU a2ps 4.14)" FSF +.SH NAME +psset \- insert page device request in PostScript files +.SH SYNOPSIS +.B psset +\fIFILE\fR +.SH DESCRIPTION +." Add any additional description here +.PP +Produce a version of the PostScript FILE with a protected call to the +PostScript operator `setpagedevice'. Typical use is making FILE +print duplex, or on the manual tray etc. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit +.TP +\fB\-q\fR, \fB\-\-quiet\fR +don't print informational messages +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR +save result in FILE. If FILE is `-', send to stdout +.TP +\fB\-n\fR, \fB\-\-no\-fix\fR +don't run `fixps' to fix PS problems in FILE +.TP +\fB\-S\fR, \fB\-\-setpagedevice\fR=\fIKEY[\fR:VALUE] +pass a page device definition to output. +Multiple values accumulate +.TP +\fB\-a\fR, \fB\-\-at\fR=\fIPAGE\fR +insert the page device definitions at PAGE. Default +is PAGE=0, standing for the Document's Setup section +.SS "Shortcuts:" +.TP +\fB\-m\fR, \fB\-\-manualfeed\fR +alias for \fB\-SManualFeed\fR:true +.TP +\fB\-s\fR, \fB\-\-simplex\fR +alias for \fB\-SDuplex\fR:false +.TP +\fB\-d\fR, \fB\-\-duplex\fR +alias for \fB\-SDuplex\fR:true \fB\-STumble\fR:false +corresponds to Duplex, binding along the long edge +.TP +\fB\-t\fR, \fB\-\-tumble\fR +alias for \fB\-SDuplex\fR:true \fB\-STumble\fR:true +corresponds to Duplex, binding along the short edge +.PP +Produced output is meant for PS level 2 printers. +.PP +News, updates and documentation: visit http://www.inf.enst.fr/~demaille/a2ps/ +.SH AUTHOR +Written by Akim Demaille. +.SH "REPORTING BUGS" +Report bugs to <bug-a2ps@gnu.org> +.SH COPYRIGHT +Copyright \(co 1998-1999 Akim Demaille, Miguel Santana +.br +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.SH "SEE ALSO" +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B psset +is maintained as a Texinfo manual. If the +.B info +and +.B psset +programs are properly installed at your site, the command +.IP +.B info psset +.PP +should give you access to the complete manual. diff --git a/man/psset.x b/man/psset.x new file mode 100644 index 0000000..d46cb61 --- /dev/null +++ b/man/psset.x @@ -0,0 +1,5 @@ +[NAME] +psset \- insert page device request in PostScript files + +[DESCRIPTION] +." Add any additional description here diff --git a/man/texi2dvi4a2ps.1 b/man/texi2dvi4a2ps.1 new file mode 100644 index 0000000..16621e4 --- /dev/null +++ b/man/texi2dvi4a2ps.1 @@ -0,0 +1,101 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.019. +.TH TEXI2DVI "1" "December 2007" "GNU Texinfo 4.1 1.1.1.1.2.3" FSF +.SH NAME +texi2dvi4a2ps \- Compile Texinfo and LaTeX files to DVI or PDF +.SH SYNOPSIS +.B texi2dvi4a2ps +[\fIOPTION\fR]... \fIFILE\fR... +.SH DESCRIPTION +Run each Texinfo or LaTeX FILE through TeX in turn until all +cross-references are resolved, building all indices. The directory +containing each FILE is searched for included files. The suffix of FILE +is used to determine its language (LaTeX or Texinfo). +.PP +Makeinfo is used to perform Texinfo macro expansion before running TeX +when needed. +.SS "Operation modes:" +.TP +\fB\-b\fR, \fB\-\-batch\fR +no interaction +.TP +\fB\-c\fR, \fB\-\-clean\fR +remove all auxiliary files +.TP +\fB\-D\fR, \fB\-\-debug\fR +turn on shell debugging (set \fB\-x\fR) +.TP +\fB\-h\fR, \fB\-\-help\fR +display this help and exit successfully +.TP +\fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR +leave output in OFILE (implies \fB\-\-clean\fR); +Only one input FILE may be specified in this case +.TP +\fB\-q\fR, \fB\-\-quiet\fR +no output unless errors (implies \fB\-\-batch\fR) +.TP +\fB\-s\fR, \fB\-\-silent\fR +same as \fB\-\-quiet\fR +.TP +\fB\-v\fR, \fB\-\-version\fR +display version information and exit successfully +.TP +\fB\-V\fR, \fB\-\-verbose\fR +report on what is done +.SS "TeX tuning:" +.TP +-@ +use @input instead of \einput; for preloaded Texinfo +.TP +\fB\-e\fR, \fB\-\-expand\fR +force macro expansion using makeinfo +.TP +\fB\-I\fR DIR +search DIR for Texinfo files +.TP +\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR +specify the LANG of FILE (LaTeX or Texinfo) +.TP +\fB\-p\fR, \fB\-\-pdf\fR +use pdftex or pdflatex for processing +.TP +\fB\-t\fR, \fB\-\-texinfo\fR=\fICMD\fR +insert CMD after @setfilename in copy of input file +multiple values accumulate +.PP +The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, +TEX (or PDFTEX), and TEXINDEX environment variables are used to run +those commands, if they are set. +.SH "REPORTING BUGS" +Email bug reports to <bug-texinfo@gnu.org>, +general questions and discussion to <help-texinfo@gnu.org>. +Texinfo home page: http://www.gnu.org/software/texinfo/ +.SH COPYRIGHT +Copyright \(co 2002 Free Software Foundation, Inc. +There is NO warranty. You may redistribute this software +under the terms of the GNU General Public License. +For more information about these matters, see the files named COPYING. +.SH "SEE ALSO" +texi2dvi4a2ps is exactly the same script as texi2dvi, part of the +package GNU Texinfo. It is used by a2ps when delegating LaTeX and +Texinfo files. Instead of checking whether the version of texi2dvi +which is installed is recent enough, it is more convenient for the +users that a2ps is shipped with the version of texi2dvi it requires. +.BR a2ps (1), +.BR card (1), +.BR fixps (1), +.BR pdiff (1), +.BR psset (1), +.BR texi2dvi4a2ps (1). +.PP +The full documentation for +.B texi2dvi +is maintained as a Texinfo manual. If the +.B info +and +.B texi2dvi +programs are properly installed at your site, the command +.IP +.B info texi2dvi +.PP +should give you access to the complete manual. diff --git a/man/texi2dvi4a2ps.x b/man/texi2dvi4a2ps.x new file mode 100644 index 0000000..152e02c --- /dev/null +++ b/man/texi2dvi4a2ps.x @@ -0,0 +1,9 @@ +[NAME] +texi2dvi4a2ps \- Compile Texinfo and LaTeX files to DVI or PDF + +[SEE ALSO] +texi2dvi4a2ps is exactly the same script as texi2dvi, part of the +package GNU Texinfo. It is used by a2ps when delegating LaTeX and +Texinfo files. Instead of checking whether the version of texi2dvi +which is installed is recent enough, it is more convenient for the +users that a2ps is shipped with the version of texi2dvi it requires. |