Re: [GENERAL] Documentation availability as a single page of text

2010-05-13 Thread Peter Eisentraut
On ons, 2010-05-12 at 15:24 +0200, John Gage wrote:
 Yes it would.  In fact, I have often wondered why this doesn't exist.   
 How can I do it?

cd doc/src/sgml
make html JADEFLAGS='-V nochunks -V rootchunk'

That will produce an index.html file with the entire documentation in
it.



-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-13 Thread Alvaro Herrera
Excerpts from Peter Eisentraut's message of jue may 13 12:10:21 -0400 2010:
 On ons, 2010-05-12 at 15:24 +0200, John Gage wrote:
  Yes it would.  In fact, I have often wondered why this doesn't exist.   
  How can I do it?
 
 cd doc/src/sgml
 make html JADEFLAGS='-V nochunks -V rootchunk'
 
 That will produce an index.html file with the entire documentation in
 it.

Hmm, this seems a useful candidate for a new make target (assuming the
resulting HTML file can be opened with a browser, that is).
-- 

-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-12 Thread Dimitri Fontaine
Alvaro Herrera alvhe...@alvh.no-ip.org writes:
 There's a texinfo output that could perhaps be useful.  Try
 make postgres.info in the doc/src/sgml directory; while it's tagged
 experimental and outputs a boatload of warnings, it does work for me and the
 text it produces is plain enough.

It's pretty good indeed. Thanks for sharing the tip.

But it's very impractical to read any table in info format, and it's
missing an index. I guess the table format could be readable if using
the equivalent of psql's \x (1 row per column) and an empty line between
rows, but I have no idea how to do it. Ditto for indexing.

Regards,
-- 
dim

-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-12 Thread Peter Eisentraut
On lör, 2010-05-08 at 11:06 +0200, John Gage wrote:
 Is the documentation available anywhere as a single page text file?   
 This would be enormously helpful for searching using regular  
 expressions in Vim, for example, or excerpting pieces for future  
 reference.

It would be pretty easy to produce a single big HTML file, if that
helps.


-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-12 Thread John Gage
Yes it would.  In fact, I have often wondered why this doesn't exist.   
How can I do it?


John


On May 12, 2010, at 12:14 PM, Peter Eisentraut wrote:


On lör, 2010-05-08 at 11:06 +0200, John Gage wrote:

Is the documentation available anywhere as a single page text file?
This would be enormously helpful for searching using regular
expressions in Vim, for example, or excerpting pieces for future
reference.


It would be pretty easy to produce a single big HTML file, if that
helps.


--
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general



--
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-10 Thread Geoffrey

Bruce Momjian wrote:

Bruce Momjian wrote:

John Gage wrote:
Is the documentation available anywhere as a single page text file?   
This would be enormously helpful for searching using regular  
expressions in Vim, for example, or excerpting pieces for future  
reference.

Uh, no, and no one has ever asked for that.  There must be some tool
that will dump an HTML tree as a single text file.


Or maybe convert the PDF file to text.


On Linux:

/usr/bin/pdftotext


--
Until later, Geoffrey

I predict future happiness for America if they can prevent
the government from wasting the labors of the people under
the pretense of taking care of them.
- Thomas Jefferson

--
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-10 Thread Alvaro Herrera
Excerpts from John Gage's message of sáb may 08 05:06:35 -0400 2010:
 Is the documentation available anywhere as a single page text file?   
 This would be enormously helpful for searching using regular  
 expressions in Vim, for example, or excerpting pieces for future  
 reference.

There's a texinfo output that could perhaps be useful.  Try
make postgres.info in the doc/src/sgml directory; while it's tagged
experimental and outputs a boatload of warnings, it does work for me and the
text it produces is plain enough.
-- 

-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-10 Thread Alvaro Herrera
Excerpts from Alvaro Herrera's message of lun may 10 12:01:22 -0400 2010:

 There's a texinfo output that could perhaps be useful.  Try
 make postgres.info in the doc/src/sgml directory; while it's tagged
 experimental and outputs a boatload of warnings, it does work for me and the
 text it produces is plain enough.

Ah, it's also *a lot* faster to produce than either PDF or HTML.
-- 

-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-10 Thread John Gage
I am using the Mac and, although the Mac does not ship with this, the  
Zotero add-on to Firefox includes it:


/Users/johngage/Library/Application Support/Firefox/Profiles/ 
m35vu1ez.default/zotero/pdftotext-MacIntel


Will try it out.  Thanks very much,

John



On May 10, 2010, at 1:58 PM, Geoffrey wrote:


Bruce Momjian wrote:

Bruce Momjian wrote:

John Gage wrote:
Is the documentation available anywhere as a single page text  
file?   This would be enormously helpful for searching using  
regular  expressions in Vim, for example, or excerpting pieces  
for future  reference.

Uh, no, and no one has ever asked for that.  There must be some tool
that will dump an HTML tree as a single text file.

Or maybe convert the PDF file to text.


On Linux:

/usr/bin/pdftotext


--
Until later, Geoffrey

I predict future happiness for America if they can prevent
the government from wasting the labors of the people under
the pretense of taking care of them.
- Thomas Jefferson

--
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general



--
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-09 Thread John Gage
Converting the pdf it text is a gruesome experience on account of  
numerous carriage returns that don't belong there, etc.


Converting the docbook file to plain text is a possible solution, but  
I don't know exactly how to do that.  I will look into it.


The documentation, as is pointed out in approximately 20% of the  
messages on the list, is extraordinary.  Plain text, ultimately, gives  
the greatest access to it IMHO.


Thanks for the reply,

John



Bruce Momjian wrote:

John Gage wrote:



Or maybe convert the PDF file to text.




--
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-08 Thread Bruce Momjian
John Gage wrote:
 Is the documentation available anywhere as a single page text file?   
 This would be enormously helpful for searching using regular  
 expressions in Vim, for example, or excerpting pieces for future  
 reference.

Uh, no, and no one has ever asked for that.  There must be some tool
that will dump an HTML tree as a single text file.

-- 
  Bruce Momjian  br...@momjian.ushttp://momjian.us
  EnterpriseDB http://enterprisedb.com

-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general


Re: [GENERAL] Documentation availability as a single page of text

2010-05-08 Thread Bruce Momjian
Bruce Momjian wrote:
 John Gage wrote:
  Is the documentation available anywhere as a single page text file?   
  This would be enormously helpful for searching using regular  
  expressions in Vim, for example, or excerpting pieces for future  
  reference.
 
 Uh, no, and no one has ever asked for that.  There must be some tool
 that will dump an HTML tree as a single text file.

Or maybe convert the PDF file to text.

-- 
  Bruce Momjian  br...@momjian.ushttp://momjian.us
  EnterpriseDB http://enterprisedb.com

-- 
Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general