develooper Front page | perl.perl5.porters | Postings from August 1999

Re: perlfunc annonations or OOB enhancements?

From:
JVromans
Date:
August 28, 1999 02:38
Subject:
Re: perlfunc annonations or OOB enhancements?
Message ID:
m2iu60l02m.fsf@phoenix.squirrel.nl
Tom Christiansen <tchrist@jhereg.perl.com> writes:

> If you look at Johan Fromans's quickref, it's written in
> hand-crafted troff.

Actually#1, it's "Vromans", not "Fromans".

Actually#2, it's written in LaTeX, but there is a specially
hand-crafted troff version to please the O'Reilly production
department. The next (unified) version will be in XML, which will be
translated to LaTeX (or whatever required) using an XML::Parser based
tool.

And yes, this tool will do a lot of intelligent 'guessing'. For
example, since it is perfectly clear to me what

  <opr>index str, substr [ , offset [ , replacement ] ]</opr>

should do, I can teach the tool to do the hard work instead of 
having to specify (over and over and over ...)

  <opr>
    <name>index</name>
    <arg>str</arg>
    <arg>substr</arg>
    <optional>
      <arg>offset</arg>
      <optional>
	<arg>replacement</arg>
      </optional>
    </optional>
  </opr>

Oops. I'm afraid I've made some enemies with both the POD and XML
people now...

-- Johan




nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About