Odd formatting in on-line docs

Started by Tom Lanealmost 22 years ago5 messagesdocs
Jump to latest
#1Tom Lane
tgl@sss.pgh.pa.us

The online copies of the documentation misformat <programlisting>
constructs, indenting lines after the first. For example at

http://www.postgresql.org/docs/7.4/static/sql-syntax.html#SQL-SYNTAX-LEXICAL

the three example SQL statements should all be indented the same. Older
versions look the same, as do the "interactive" versions. But the
developer version of the docs is fine:

http://developer.postgresql.org/docs/postgres/sql-syntax.html#SQL-SYNTAX-LEXICAL

I think this must be some weird interaction between the docs themselves
and the HTML wrapper that's put around them to make the online pages.
Can anyone diagnose this and fix it?

regards, tom lane

#2Dave Page
dpage@pgadmin.org
In reply to: Tom Lane (#1)
Re: Odd formatting in on-line docs

-----Original Message-----
From: Tom Lane [mailto:tgl@sss.pgh.pa.us]
Sent: 17 April 2004 17:56
To: pgsql-www@postgresql.org; pgsql-docs@postgresql.org
Subject: [pgsql-www] Odd formatting in on-line docs

I think this must be some weird interaction between the docs
themselves and the HTML wrapper that's put around them to
make the online pages.
Can anyone diagnose this and fix it?

Yup, think I got it. The kludge of a program that loads the docs into
the database was adding a space at the beginning of the second and
subsequent lines inside <pre> tags. It's fixed for the 7.4 docs - at
some point I will reload the rest of them but I'm a little pushed for
time right now.

Regards, Dave

#3Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#1)
Re: Odd formatting in on-line docs

Tom Lane wrote:

The online copies of the documentation misformat <programlisting>
constructs, indenting lines after the first. For example at

http://www.postgresql.org/docs/7.4/static/sql-syntax.html#SQL-SYNTAX-LEXICAL

the three example SQL statements should all be indented the same. Older
versions look the same, as do the "interactive" versions. But the
developer version of the docs is fine:

http://developer.postgresql.org/docs/postgres/sql-syntax.html#SQL-SYNTAX-LEXICAL

I think this must be some weird interaction between the docs themselves
and the HTML wrapper that's put around them to make the online pages.
Can anyone diagnose this and fix it?

Someone must have fixed it:

SELECT * FROM MY_TABLE;
UPDATE MY_TABLE SET A = 5;
INSERT INTO MY_TABLE VALUES (3, 'hi there');

It isn't indented like the developer docs, but it isn't misaligned.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073
#4Dave Page
dpage@pgadmin.org
In reply to: Bruce Momjian (#3)
Re: Odd formatting in on-line docs

-----Original Message-----
From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
Sent: 20 April 2004 02:04
To: Tom Lane
Cc: pgsql-www@postgresql.org; pgsql-docs@postgresql.org
Subject: Re: [pgsql-www] Odd formatting in on-line docs

Someone must have fixed it:

SELECT * FROM MY_TABLE;
UPDATE MY_TABLE SET A = 5;
INSERT INTO MY_TABLE VALUES (3, 'hi there');

It isn't indented like the developer docs, but it isn't misaligned.

I did, and I responded to the lists. I'm seeing some duplicate messages
and long posting delays at the moment - is there a problem Marc?

Regards, Dave.

#5The Hermit Hacker
scrappy@hub.org
In reply to: Dave Page (#4)
Re: Odd formatting in on-line docs

On Tue, 20 Apr 2004, Dave Page wrote:

-----Original Message-----
From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
Sent: 20 April 2004 02:04
To: Tom Lane
Cc: pgsql-www@postgresql.org; pgsql-docs@postgresql.org
Subject: Re: [pgsql-www] Odd formatting in on-line docs

Someone must have fixed it:

SELECT * FROM MY_TABLE;
UPDATE MY_TABLE SET A = 5;
INSERT INTO MY_TABLE VALUES (3, 'hi there');

It isn't indented like the developer docs, but it isn't misaligned.

I did, and I responded to the lists. I'm seeing some duplicate messages
and long posting delays at the moment - is there a problem Marc?

any delays are most likely in that it, for some reason, is having to be
approved by myself ...

----
Marc G. Fournier Hub.Org Networking Services (http://www.hub.org)
Email: scrappy@hub.org Yahoo!: yscrappy ICQ: 7615664