dbTalk Databases Forums  

[BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz

mailing.database.pgsql-bugs mailing.database.pgsql-bugs


Discuss [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz in the mailing.database.pgsql-bugs forum.



Reply
 
Thread Tools Display Modes
  #1  
Old   
Jari Aalto
 
Posts: n/a

Default [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz - 10-22-2005 , 10:49 AM







The following bug has been logged online:

Bug reference: 1986
Logged by: Jari Aalto
Email address: jari.aalto (AT) cante (DOT) net
PostgreSQL version: 8.0.4
Operating system: Windows 2000 sp 5
Description: Please include ONE BIG .txt and .HTML file in
*docs*.tar.gz
Details:

The postgreSQL documentation archive provides *.sgml sources. Please
consider also providing following files in the archive:

<postgresql-N.N>/doc/html/manual.html
<postgresql-N.N>/doc/html/manual.txt

This ONE BIG file will help loading it off-line to
a web browser (or editor *.txt), and to make quick searches on backward and
forward.

Jari

---------------------------(end of broadcast)---------------------------
TIP 6: explain analyze is your friend

Reply With Quote
  #2  
Old   
Peter Eisentraut
 
Posts: n/a

Default Re: [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz - 10-22-2005 , 01:13 PM






Am Freitag, 21. Oktober 2005 17:31 schrieb Jari Aalto:
Quote:
This ONE BIG file will help loading it off-line to
a web browser (or editor *.txt), and to make quick searches on backward and
forward.
This wouldn't be hard to implement. Are others interested in this?

---------------------------(end of broadcast)---------------------------
TIP 4: Have you searched our list archives?

http://archives.postgresql.org


Reply With Quote
  #3  
Old   
Tom Lane
 
Posts: n/a

Default Re: [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz - 10-22-2005 , 02:00 PM



Peter Eisentraut <peter_e (AT) gmx (DOT) net> writes:
Quote:
Am Freitag, 21. Oktober 2005 17:31 schrieb Jari Aalto:
This ONE BIG file will help loading it off-line to
a web browser (or editor *.txt), and to make quick searches on backward and
forward.

This wouldn't be hard to implement. Are others interested in this?
I'd object to bloating the tarball itself with two redundant copies of
the documentation ... especially on the basis of only one request.
But couldn't we make such a version available for separate download
by those who want it?

regards, tom lane

---------------------------(end of broadcast)---------------------------
TIP 5: don't forget to increase your free space map settings


Reply With Quote
  #4  
Old   
Magnus Hagander
 
Posts: n/a

Default Re: [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz - 10-23-2005 , 11:55 AM



Quote:
This ONE BIG file will help loading it off-line to a web=20
browser (or=20
editor *.txt), and to make quick searches on backward and forward.
=20
This wouldn't be hard to implement. Are others interested in this?
The original bug talked about Windows - I'd just like to add that on
Windows we will already do this on 8.1, in the form of a CHM file.
That doesn't mean we shouldn't do sometihng for other platforms, though
;-)

//Magnus

---------------------------(end of broadcast)---------------------------
TIP 9: In versions below 8.0, the planner will ignore your desire to
choose an index scan if your joining column's datatypes do not
match


Reply With Quote
  #5  
Old   
Jari Aalto
 
Posts: n/a

Default Re: [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz - 10-23-2005 , 12:06 PM



| Peter Eisentraut <peter_e AT gmx.net> writes:
Quote:
Am Freitag, 21. Oktober 2005 17:31 schrieb Jari Aalto:
This ONE BIG file will help loading it off-line to
a web browser (or editor *.txt), and to make quick searches on backward and
forward.

This wouldn't be hard to implement. Are others interested in this?

I'd object to bloating the tarball itself with two redundant copies of
the documentation ... especially on the basis of only one request.
But couldn't we make such a version available for separate download
by those who want it?
Thanks fo taking this issue forward. It would increase the
archive much because html and text files compress extremely
well. The logical place for the documentation, is the "doc"
package that already includes FAQ.

Perhaps you meant to separate:

- pure source (*.sgml): *-doc-source.tar.gz
- generated files: *-doc-generated.tar.gz

Jari





---------------------------(end of broadcast)---------------------------
TIP 9: In versions below 8.0, the planner will ignore your desire to
choose an index scan if your joining column's datatypes do not
match


Reply With Quote
  #6  
Old   
Jari Aalto
 
Posts: n/a

Default Re: [BUGS] BUG #1986: Please include ONE BIG .txt and .HTML file in *docs*.tar.gz - 10-24-2005 , 04:07 PM



| > > This ONE BIG file will help loading it off-line to a web=20
Quote:
browser (or=20
editor *.txt), and to make quick searches on backward and forward.
=20
This wouldn't be hard to implement. Are others interested in this?

The original bug talked about Windows - I'd just like to add that on
Windows we will already do this on 8.1, in the form of a CHM file.
That doesn't mean we shouldn't do sometihng for other platforms, though
If I mentioned Windows, that was a mistake. I was talking in general interest.

The *.chm file is no subtitute for good text editor with
excellent search capabilities like Emacs + M-x occur / C-s /
C-r with word grabbing and all other features. Emacs is
available to Win32 as well.

The BIG HTML file is user friendly for student classes,
where it it posisble to serch within the browser window with
"find" to demonstrate the various places.

The one HTML also servers as a Printer format.

Jari

---------------------------(end of broadcast)---------------------------
TIP 5: don't forget to increase your free space map settings


Reply With Quote
Reply




Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off



Powered by vBulletin Version 3.5.3
Copyright ©2000 - 2012, Jelsoft Enterprises Ltd.