pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedincorrect HTML.index output
3+ messages / 2 participants
[nested] [flat]
* incorrect HTML.index output
@ 2007-10-06 20:36 Alvaro Herrera <alvherre@commandprompt.com>
0 siblings, 1 reply; 3+ messages in thread
From: Alvaro Herrera @ 2007-10-06 20:36 UTC (permalink / raw)
To: pgsql-docs
Hi,
I just noticed that on bookindex.html, we have this entry:
π, Mathematical Functions and Operators
This is an entry for "pi". In the HTML it looks like
&#960;, Mathematical Functions and Operators
So the actual problem is that we're escaping the & twice. The problem
is in HTML.index, which looks like this:
INDEXTERM functions-math.html
INDEXPOINT functions-math.html#AEN6970
TITLE Mathematical Functions and Operators
significance NORMAL
PRIMARY π
/INDEXTERM
However, it's not as easy as disabling the escape of &, because we also
have this entry:
INDEXTERM functions-textsearch.html#FUNCTIONS-TEXTSEARCH-TSQUERY
INDEXPOINT functions-textsearch.html#AEN13687
TITLE tsquery
significance NORMAL
PRIMARY TSQUERY && TSQUERY
/INDEXTERM
So these & must be escaped, otherwise this operator wouldn't be
displayed correctly.
I'm unsure what to do about it. To me, the simplest solution seems to
be to just remove the index entry.
--
Alvaro Herrera http://www.advogato.org/person/alvherre
Major Fambrough: You wish to see the frontier?
John Dunbar: Yes sir, before it's gone.
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: incorrect HTML.index output
@ 2007-10-07 01:04 Tom Lane <tgl@sss.pgh.pa.us>
parent: Alvaro Herrera <alvherre@commandprompt.com>
0 siblings, 1 reply; 3+ messages in thread
From: Tom Lane @ 2007-10-07 01:04 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@commandprompt.com>; +Cc: pgsql-docs
Alvaro Herrera <alvherre@commandprompt.com> writes:
> I just noticed that on bookindex.html, we have this entry:
> π, Mathematical Functions and Operators
> ...
> I'm unsure what to do about it. To me, the simplest solution seems to
> be to just remove the index entry.
Then it wouldn't be indexed at all. I suggest just not trying to be
so cute, and change the index entry like this:
<indexterm>
- <primary>π</primary>
+ <primary>pi</primary>
</indexterm>
regards, tom lane
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: incorrect HTML.index output
@ 2007-10-07 01:13 Alvaro Herrera <alvherre@commandprompt.com>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 3+ messages in thread
From: Alvaro Herrera @ 2007-10-07 01:13 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-docs
Tom Lane wrote:
> Alvaro Herrera <alvherre@commandprompt.com> writes:
> > I just noticed that on bookindex.html, we have this entry:
> > π, Mathematical Functions and Operators
> > ...
> > I'm unsure what to do about it. To me, the simplest solution seems to
> > be to just remove the index entry.
>
> Then it wouldn't be indexed at all. I suggest just not trying to be
> so cute, and change the index entry like this:
>
> <indexterm>
> - <primary>π</primary>
> + <primary>pi</primary>
> </indexterm>
That seems simple enough :-) Done.
--
Alvaro Herrera Developer, http://www.PostgreSQL.org/
"Doing what he did amounts to sticking his fingers under the hood of the
implementation; if he gets his fingers burnt, it's his problem." (Tom Lane)
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2007-10-07 01:13 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2007-10-06 20:36 incorrect HTML.index output Alvaro Herrera <alvherre@commandprompt.com>
2007-10-07 01:04 ` Tom Lane <tgl@sss.pgh.pa.us>
2007-10-07 01:13 ` Alvaro Herrera <alvherre@commandprompt.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox