Re: [DOCS] [BUGS] BUG #1414: DOC - pl/Perl hash tags

From: Alexey Borzov <borz_off(at)cs(dot)msu(dot)su>
To: Magnus Hagander <mha(at)sollentuna(dot)net>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Mike Blackwell <maiku41(at)anet(dot)com>, pgsql-docs(at)postgresql(dot)org, pgsql-www(at)postgresql(dot)org
Subject: Re: [DOCS] [BUGS] BUG #1414: DOC - pl/Perl hash tags
Date: 2005-01-20 21:28:44
Message-ID: 41F0228C.60802@cs.msu.su
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

Hi,

Magnus Hagander wrote:
>>>In the pl/Perl section of the 8.0.0 manual, as viewed on the
>>
>>postgresql.org
>>
>>>web site, all perl code hash tags seem to be missing. i.e.
>>
>>Yeah, I see the same; but it's not in the devel docs. Compare
>> http://www.postgresql.org/docs/8.0/static/plperl.html
>> http://developer.postgresql.org/docs/postgres/plperl.html
>>and look for instance at the empcomp() function about halfway down
>>the page:
>> return $emp-> + $emp->;
>>vs
>> return $emp->{basesalary} + $emp->{bonus};
>>
>>Any theories what's wrong here?
>
>
> Going out on a line a bit here - and someone who've worked with teh
> system probably knows for sure but... It looks like {} is used as the
> template placeholder in the templating system on the website.

Yes, that's exactly the case...

> It would seem to me that the fix would be as simple as to set
> $removeUnknownVariables to false when parsing the docs template, but I'm
> far from sure at that. And I have no way to test it. And it might break
> something else. End of disclaimers.

The clean solution would be to use
$tpl->setOption('preserve_data', true);

In this case there will be no problems even if a known placeholder appears in
the docs.

Sorry, cannot fix it myself right now, don't want to checkout the website code
as there is a sh*tload of PDF docs in there.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Magnus Hagander 2005-01-20 21:36:33 Re: [DOCS] [BUGS] BUG #1414: DOC - pl/Perl hash tags missing
Previous Message Tom Lane 2005-01-20 21:23:16 Re: [DOCS] [BUGS] BUG #1414: DOC - pl/Perl hash tags missing

Browse pgsql-www by date

  From Date Subject
Next Message Magnus Hagander 2005-01-20 21:36:33 Re: [DOCS] [BUGS] BUG #1414: DOC - pl/Perl hash tags missing
Previous Message Tom Lane 2005-01-20 21:23:16 Re: [DOCS] [BUGS] BUG #1414: DOC - pl/Perl hash tags missing