[Gs-devel] [PATCH] combining eps2eps manpage (was Re: Manpages: Translation)

[Ralph Giles]

On Wed, 25 Oct 2000, L. Peter Deutsch wrote:

> Is there a convenient way for 'man ps2ps' and 'man eps2eps' to return the
> same page?  Maybe just by using a symbolic link?  If so, combining the pages
> seems like a fine idea.

Here's a patch, submitted for your approval before I commit since it
touches a makefile. It combines the eps2eps manpage with the ps2ps one,
and installs the one as a symlink to the other.

It also fixes an apparent bug in unixinst.mak where the symlinking we were
already doing would fail, blocking further make install.

I'm used to hardlinks for this, but (despite the evidence of the installed
system :) the Debian policy asks for symlinks and principle of least
surprise, so since we were already doing them I went that way. I don't
mean to be partisan by always citing Debian, but they (a) have a
reputation for trying to do things "right" and (b) are what I'm most
familiar with among the *nix.

I still haven't written install code for the localized documentation. I
guess the thing to do is add an outer loop (for l in MAN_LOCALIZATIONS;)
around the existing install code?

I'm also assuming we're going to want to merge the new docs into 6.5. I'd
prefer to wait until we've got more-or-less complete translations and do a
big update, but of course that needs to happen before the later test
cycles.

Cheers,
 -ralph

--
giles at ashlu.bc.ca
-------------- next part --------------
Index: man/ps2ps.1
===================================================================
RCS file: /cvsroot/ghostscript/gs/man/ps2ps.1,v
retrieving revision 1.7
diff -u -r1.7 ps2ps.1
--- man/ps2ps.1	2000/10/04 05:18:54	1.7
+++ man/ps2ps.1	2000/10/26 10:18:37
@@ -1,9 +1,11 @@
 .\" $Id: ps2ps.1,v 1.7 2000/10/04 05:18:54 raph Exp $
-.TH PS2PS 1 "7 August 2000" 6.21 "Ghostscript Tools" \" -*- nroff -*-
+.TH PS2PS 1 "25 October 2000" 6.30 "Ghostscript Tools" \" -*- nroff -*-
 .SH NAME
-ps2ps \- Ghostscript PostScript "distiller"
+ps2ps, eps2eps \- Ghostscript PostScript "distiller"
 .SH SYNOPSIS
 \fBps2ps\fR [ \fIoptions\fR ] \fIinput.ps output.ps\fR
+.br
+\fBeps2eps\fR [ \fIoptions\fR ] \fIinput.eps output.eps\fR
 .SH DESCRIPTION
 \fBps2ps\fR uses \fIgs\fR(1) to convert \fBPostScript\fR(tm) file
 "input.ps" to simpler and (usually) faster PostScript in
@@ -11,12 +13,12 @@
 constructs, but the \fB\-dLanguageLevel=1\fR option restricts the output to
 Level 1.
 .PP
-Use \fBps2ps\fR only for ordinary PostScript (PS) files; for
-Encapsulated PostScript (EPS) files, use \fBeps2eps\fR.
+\fBeps2eps\fR performs the equivalent optimization for Encapsulated
+PostScript (EPS) files. 
 .SH FILES
 Run "\fBgs -h\fR" to find the location of Ghostscript documentation on your
 system, from which you can get more details.
 .SH VERSION
-This document was last revised for Ghostscript version 6.21.
+This document was last revised for Ghostscript version 6.30.
 .SH AUTHOR
 L. Peter Deutsch <ghost at aladdin.com>
Index: src/unixinst.mak
===================================================================
RCS file: /cvsroot/ghostscript/gs/src/unixinst.mak,v
retrieving revision 1.13
diff -u -r1.13 unixinst.mak
--- src/unixinst.mak	2000/09/19 19:00:52	1.13
+++ src/unixinst.mak	2000/10/26 10:18:38
@@ -54,9 +54,10 @@
 PSEXDIR=$(PSLIBDIR)/../examples
 PSMANDIR=$(PSLIBDIR)/../man
 
-MAN1_PAGES=gs gslp gsnd dvipdf eps2eps font2c pdf2dsc pdf2ps pdfopt \
+MAN1_PAGES=gs gslp gsnd dvipdf font2c pdf2dsc pdf2ps pdfopt \
 	   pf2afm pfbtopfa printafm ps2ascii ps2epsi \
 	   ps2pdf ps2pdfwr ps2ps wftopfa
+MAN1_PS2PS_LINKS=eps2eps
 MAN1_PS2PDF_LINKS=ps2pdf12 ps2pdf13
 MAN1_GSLP_LINKS=gsbj gsdj gsdj500 gslj
 # There's no point in providing a complete dependency list: we include
@@ -67,11 +68,17 @@
 	$(SH) -c 'for f in $(MAN1_PAGES) ;\
 	do if ( test -f $(PSMANDIR)/$$f.1 ); then $(INSTALL_DATA) $(PSMANDIR)/$$f.1 $(man1dir)/$$f.$(man1ext); fi;\
 	done'
+	$(SH) -c 'for f in $(MAN1_PS2PS_LINKS) ;\
+	do rm -f $(man1dir)/$$f.$(man1ext);\
+	ln -s $(man1dir)/ps2ps.1 $(man1dir)/$$f.$(man1ext);\
+ 	done'
 	$(SH) -c 'for f in $(MAN1_PS2PDF_LINKS) ;\
-	do rm -f $(man1dir)/$$f.$(man1ext); ln -s ps2pdf.1 $(man1dir)/$$f.$(man1ext);\
+	do rm -f $(man1dir)/$$f.$(man1ext);\
+	ln -s $(man1dir)/ps2pdf.1 $(man1dir)/$$f.$(man1ext);\
 	done'
 	$(SH) -c 'for f in $(MAN1_GSLP_LINKS) ;\
-	do rm -f $(man1dir)/$$f.$(man1ext); ln -s gslp.1 $(man1dir)/$$f.$(man1ext);\
+	do rm -f $(man1dir)/$$f.$(man1ext);\
+	ln -s $(man1dir)/gslp.1 $(man1dir)/$$f.$(man1ext);\
 	done'
 	-mkdir $(datadir)
 	-mkdir $(gsdir)