public inbox for [email protected]help / color / mirror / Atom feed
Texinfo docs/target 7+ messages / 3 participants [nested] [flat]
* Texinfo docs/target @ 2005-11-19 21:41 Andreas Seltenreich <[email protected]> 0 siblings, 1 reply; 7+ messages in thread From: Andreas Seltenreich @ 2005-11-19 21:41 UTC (permalink / raw) To: pgsql-docs I've been using a texinfo (more precisely: info) version of the docs for some weeks now, and really came to love it. It is still the version I mentioned here: <http://archives.postgresql.org/pgsql-general/2005-10/msg01813.php; Now I'm wondering, if it'd be worth fixing the index and some minor encoding deficiencies (e.g. medium-length dashes end up as "[mdash]"), and adding Autoconf support in order to make it a proper target. I remember other requests for info-docs on the lists than the above, but it is rather hard to search for them :-/. regards, Andreas -- ^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Texinfo docs/target @ 2005-11-19 22:07 Peter Eisentraut <[email protected]> parent: Andreas Seltenreich <[email protected]> 0 siblings, 1 reply; 7+ messages in thread From: Peter Eisentraut @ 2005-11-19 22:07 UTC (permalink / raw) To: Andreas Seltenreich <[email protected]>; +Cc: pgsql-docs Andreas Seltenreich wrote: > Now I'm wondering, if it'd be worth fixing the index and some minor > encoding deficiencies (e.g. medium-length dashes end up as > "[mdash]"), and adding Autoconf support in order to make it a proper > target. We probably won't ship it with the default distribution, but I don't see any harm in at least providing build support for it initially. -- Peter Eisentraut http://developer.postgresql.org/~petere/ ^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Texinfo docs/target @ 2006-09-29 04:32 Andreas Seltenreich <[email protected]> parent: Peter Eisentraut <[email protected]> 0 siblings, 2 replies; 7+ messages in thread From: Andreas Seltenreich @ 2006-09-29 04:32 UTC (permalink / raw) To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs Peter Eisentraut <[email protected]> writes: > Andreas Seltenreich wrote: >> Now I'm wondering, if it'd be worth fixing the index and some minor >> encoding deficiencies (e.g. medium-length dashes end up as >> "[mdash]"), and adding Autoconf support in order to make it a proper >> target. > > We probably won't ship it with the default distribution, but I don't see > any harm in at least providing build support for it initially. The index seems to work with more recent versions of DB2X, and the apparent encoding problems turned out to be an overlook in the postgres.xml target. I had to run makeinfo with the --no-validate option, mostly because the info design doesn't allow duplicate node names. However, it doesn't seem to impair navigation besides addressing nodes by name, and since most of the duplicate names are nodes like "Changes" in the release notes section, I don't think it will be more of a nuisance than being unable to look up Pi in the index... I figured adding autoconf support for db2x/info wouldn't be very wise as long as the experimental postgres.xml target the new rules depend on doesn't have any either. Patch attached. regards, andreas Attachments: [text/x-patch] Makefile.diff (1.4K, 2-Makefile.diff) download | inline diff: Index: doc/src/sgml/Makefile =================================================================== RCS file: /projects/cvsroot/pgsql/doc/src/sgml/Makefile,v retrieving revision 1.76 diff -u -r1.76 Makefile --- doc/src/sgml/Makefile 6 Apr 2006 18:54:36 -0000 1.76 +++ doc/src/sgml/Makefile 29 Sep 2006 04:27:59 -0000 @@ -212,7 +212,7 @@ postgres.xml: postgres.sgml $(GENERATED_SGML) $(OSX) -x lower $< | \ - sed -e 's/\[\(lt\|gt\|amp\|nbsp\|copy\|quot\|ouml\|uuml\|egrave\) *\]/\&\1;/g' \ + sed -e 's/\[\(amp\|copy\|egrave\|gt\|lt\|mdash\|nbsp\|ouml\|pi\|quot\|uuml\) *\]/\&\1;/g' \ -e '1a\' -e '<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">' \ >$@ @@ -222,6 +222,24 @@ htmlhelp: stylesheet-hh.xsl postgres.xml $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam pg.version '$(VERSION)' $^ +## +## Experimental Texinfo targets +## + +DB2X_TEXIXML = db2x_texixml +DB2X_XSLTPROC = db2x_xsltproc +MAKEINFO = makeinfo + +postgres.texixml: postgres.xml + $(DB2X_XSLTPROC) -s texi $< -o $@ + +postgres.texi: postgres.texixml + $(DB2X_TEXIXML) --encoding=iso-8859-1//TRANSLIT $< \ + --to-stdout > $@ + +postgres.info: postgres.texi + $(MAKEINFO) --enable-encoding --no-split \ + --no-validate $< -o $@ ## ## Check @@ -249,3 +267,5 @@ rm -f INSTALL HISTORY regress_README # XML rm -f postgres.xml htmlhelp.hhp toc.hhc index.hhk +# Texinfo + rm -f *.texixml *.texi *.info db2texi.refs ^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Texinfo docs/target @ 2006-10-03 00:43 Bruce Momjian <[email protected]> parent: Andreas Seltenreich <[email protected]> 1 sibling, 0 replies; 7+ messages in thread From: Bruce Momjian @ 2006-10-03 00:43 UTC (permalink / raw) To: Andreas Seltenreich <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs Your patch has been added to the PostgreSQL unapplied patches list at: http://momjian.postgresql.org/cgi-bin/pgpatches It will be applied as soon as one of the PostgreSQL committers reviews and approves it. --------------------------------------------------------------------------- Andreas Seltenreich wrote: > Peter Eisentraut <[email protected]> writes: > > > Andreas Seltenreich wrote: > >> Now I'm wondering, if it'd be worth fixing the index and some minor > >> encoding deficiencies (e.g. medium-length dashes end up as > >> "[mdash]"), and adding Autoconf support in order to make it a proper > >> target. > > > > We probably won't ship it with the default distribution, but I don't see > > any harm in at least providing build support for it initially. > > The index seems to work with more recent versions of DB2X, and the > apparent encoding problems turned out to be an overlook in the > postgres.xml target. > > I had to run makeinfo with the --no-validate option, mostly because > the info design doesn't allow duplicate node names. However, it > doesn't seem to impair navigation besides addressing nodes by name, > and since most of the duplicate names are nodes like "Changes" in the > release notes section, I don't think it will be more of a nuisance > than being unable to look up Pi in the index... > > I figured adding autoconf support for db2x/info wouldn't be very wise > as long as the experimental postgres.xml target the new rules depend > on doesn't have any either. > > Patch attached. > > regards, > andreas > > > ---------------------------(end of broadcast)--------------------------- > TIP 4: Have you searched our list archives? > > http://archives.postgresql.org -- Bruce Momjian [email protected] EnterpriseDB http://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Texinfo docs/target @ 2006-10-03 21:13 Bruce Momjian <[email protected]> parent: Andreas Seltenreich <[email protected]> 1 sibling, 1 reply; 7+ messages in thread From: Bruce Momjian @ 2006-10-03 21:13 UTC (permalink / raw) To: Andreas Seltenreich <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs Patch applied. Thanks. --------------------------------------------------------------------------- Andreas Seltenreich wrote: > Peter Eisentraut <[email protected]> writes: > > > Andreas Seltenreich wrote: > >> Now I'm wondering, if it'd be worth fixing the index and some minor > >> encoding deficiencies (e.g. medium-length dashes end up as > >> "[mdash]"), and adding Autoconf support in order to make it a proper > >> target. > > > > We probably won't ship it with the default distribution, but I don't see > > any harm in at least providing build support for it initially. > > The index seems to work with more recent versions of DB2X, and the > apparent encoding problems turned out to be an overlook in the > postgres.xml target. > > I had to run makeinfo with the --no-validate option, mostly because > the info design doesn't allow duplicate node names. However, it > doesn't seem to impair navigation besides addressing nodes by name, > and since most of the duplicate names are nodes like "Changes" in the > release notes section, I don't think it will be more of a nuisance > than being unable to look up Pi in the index... > > I figured adding autoconf support for db2x/info wouldn't be very wise > as long as the experimental postgres.xml target the new rules depend > on doesn't have any either. > > Patch attached. > > regards, > andreas > > > ---------------------------(end of broadcast)--------------------------- > TIP 4: Have you searched our list archives? > > http://archives.postgresql.org -- Bruce Momjian [email protected] EnterpriseDB http://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Texinfo docs/target @ 2006-10-05 00:53 Andreas Seltenreich <[email protected]> parent: Bruce Momjian <[email protected]> 0 siblings, 1 reply; 7+ messages in thread From: Andreas Seltenreich @ 2006-10-05 00:53 UTC (permalink / raw) To: Bruce Momjian <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs Bruce Momjian writes: > Patch applied. Thanks. Here's a small update to pass the basename of the target as a stylesheet parameter. This makes the resulting info file work properly when compressed or split. It also prevents Debian's "install-info" script from choking. Thanks, andreas Attachments: [text/x-patch] Makefile.diff (580B, 2-Makefile.diff) download | inline diff: Index: doc/src/sgml/Makefile =================================================================== RCS file: /projects/cvsroot/pgsql/doc/src/sgml/Makefile,v retrieving revision 1.77 diff -u -r1.77 Makefile --- doc/src/sgml/Makefile 3 Oct 2006 21:13:17 -0000 1.77 +++ doc/src/sgml/Makefile 5 Oct 2006 00:32:33 -0000 @@ -231,7 +231,7 @@ MAKEINFO = makeinfo postgres.texixml: postgres.xml - $(DB2X_XSLTPROC) -s texi $< -o $@ + $(DB2X_XSLTPROC) -s texi -g output-file=$(basename $@) $< -o $@ postgres.texi: postgres.texixml $(DB2X_TEXIXML) --encoding=iso-8859-1//TRANSLIT $< \ ^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Texinfo docs/target @ 2006-10-05 02:04 Bruce Momjian <[email protected]> parent: Andreas Seltenreich <[email protected]> 0 siblings, 0 replies; 7+ messages in thread From: Bruce Momjian @ 2006-10-05 02:04 UTC (permalink / raw) To: Andreas Seltenreich <[email protected]>; +Cc: Peter Eisentraut <[email protected]>; pgsql-docs Andreas Seltenreich wrote: > Bruce Momjian writes: > > > Patch applied. Thanks. > > Here's a small update to pass the basename of the target as a > stylesheet parameter. This makes the resulting info file work > properly when compressed or split. It also prevents Debian's > "install-info" script from choking. Applied. Thanks. -- Bruce Momjian [email protected] EnterpriseDB http://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2006-10-05 02:04 UTC | newest] Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2005-11-19 21:41 Texinfo docs/target Andreas Seltenreich <[email protected]> 2005-11-19 22:07 ` Peter Eisentraut <[email protected]> 2006-09-29 04:32 ` Andreas Seltenreich <[email protected]> 2006-10-03 00:43 ` Bruce Momjian <[email protected]> 2006-10-03 21:13 ` Bruce Momjian <[email protected]> 2006-10-05 00:53 ` Andreas Seltenreich <[email protected]> 2006-10-05 02:04 ` Bruce Momjian <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox