Re: [DOCS] [HACKERS] timestamptz alias
Hi, Jim, Jim C. Nasby wrote: > An issue I've seen with the docs is that for chapters that have a lot of > sections (such as 8), the section list at the start of each chapter > fills the screen, so it's easy to miss the fact that there's more info > beneath the list (which is wy presumably most folks never knew that > table existed). > > I think the ideal way to handle this would be to put the table of > contents in a side-bar and flow the text around it. But that could be a > real bear to do in docbook/sgml, so perhaps it would be better to just > force the TOC for each chapter onto it's own page (and ensure the > overview/introduction text shows up in the TOC). I agree. The fact that the TOC and the first part of the Chapter are on the same page has annoyed me several times now. :-) Regards, Markus -- Markus Schaber | Logical Tracking&Tracing International AG Dipl. Inf. | Software Development GIS Fight against software patents in Europe! www.ffii.org www.nosoftwarepatents.org signature.asc Description: OpenPGP digital signature
Re: [DOCS] [HACKERS] timestamptz alias
> I would like a frame driven version of the docs (c.f. > doxygen, javadoc, etc.). The we would not need contents links > at the top of each chapter like this. Navigating the HTML > docs is less than pleasant. > Unfortunately, I don't have enough time or docbook-fu to be > able to do this. Yuck. Frames. Ickk. All the issues with bookmarking and searching and things like that. Anyway. If done, make sure the current version doesn't go away, but make the frames version just an option instead. //Magnus ---(end of broadcast)--- TIP 4: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] [HACKERS] timestamptz alias
Magnus Hagander wrote: I would like a frame driven version of the docs (c.f. doxygen, javadoc, etc.). The we would not need contents links at the top of each chapter like this. Navigating the HTML docs is less than pleasant. Unfortunately, I don't have enough time or docbook-fu to be able to do this. Yuck. Frames. Ickk. All the issues with bookmarking and searching and things like that. Anyway. If done, make sure the current version doesn't go away, but make the frames version just an option instead. Then use a tiled mechanism instead if you want to avoid frames. Or if you want to be get more advanced some sort of Ajax solution. But we need some sort of nav bar that you can drill down on. Navigation now is just horrible, IMNSHO. cheers andrew ---(end of broadcast)--- TIP 2: Don't 'kill -9' the postmaster
Re: [DOCS] Texinfo docs/target
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 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 - 1.77 +++ doc/src/sgml/Makefile 5 Oct 2006 00:32:33 - @@ -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 $< \ ---(end of broadcast)--- TIP 1: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] Texinfo docs/target
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] EnterpriseDBhttp://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ---(end of broadcast)--- TIP 6: explain analyze is your friend
