Mailing-List: contact embperl-help@perl.apache.org; run by ezmlm
Precedence: bulk
From: "Beau E. Cox" <beau@beaucox.com>
Organization: BeauCox.com
To: embperl@perl.apache.org
Subject: Documentation
Date: Wed, 21 Apr 2004 11:46:11 -1000
User-Agent: KMail/1.6.2
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="us-ascii"
Content-Transfer-Encoding: 7bit
Message-Id: <200404211146.11912.beau@beaucox.com>

Hi -

Please understand, I'm not trying to be rude. I understand that
most of us open-source folks have other 'real' jobs and time for
our real calling (open-source playing) is sometimes extremely
limited.

But I wish the Embperl docs were better, at least in a cosmetic
sense. For example, at least with my browser (Mozilla 1.7 on Linux
2.6.6-rc1 via kde 3.2.2), I have the following problems with
the Embperl website:

1) Some pages seem to 'get stuck' in <pre> mode. The page:

http://perl.apache.org/embperl/pod/doc/Config.-page-1-.htm#sect_2

siwtches to <pre> after the mod_perl section, and stays there until
the Embperl_Object_Stopdir section. This takes all of the sections
caught in <pre> out of the index, and forces us to read raw 'pod'
format. At first I thought it was some minor syntax error in Config.pod
(extra space on a 'blank' line, etc.) but when I did a pod2html on
Config.pod in the distribution root, the resulting html file was
perfect.

2) Sections not in <pre> that should be. When I look at:

http://perl.apache.org/embperl/pod/intro/IntroEmbperlObject.-page-3-.htm#sect_2

the example httpd.conf VirtualHost is not <pre>ed and makes it almost
impossible to read.

3) Sections which are html shown as plain text. README.v2 at:

http://perl.apache.org/embperl/pod/doc/README.v2

is show as plain text on my browser and is completely worthless online.
Of course, I can read it fine with emacs from the distribution root.

Errors like the above are _not_ a very good advertisement for Embperl.

So now that I have this off my chest, is there any way I can help?

Aloha => Beau;


---------------------------------------------------------------------
To unsubscribe, e-mail: embperl-unsubscribe@perl.apache.org
For additional commands, e-mail: embperl-help@perl.apache.org