[PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread James Cox

I have deleted this note, but it may be worth discussing...

-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
Sent: Thursday, January 31, 2002 10:10 AM
To: [EMAIL PROTECTED]
Subject: [PHP-NOTES] note 18678 added to index


A suggestion for the manual pages:
It's time to categorize them into higher-level sections, e.g. built-in
modules, communication modules, db modules, security modules, graphics
modules etc. Even as an experienced user, I find it difficult to locate the
right section now. New users must be totally confused. Thank you.
--
http://www.php.net/manual/en/index.php
http://master.php.net/manage/user-notes.php?action=edit+18678
http://master.php.net/manage/user-notes.php?action=delete+18678
http://master.php.net/manage/user-notes.php?action=reject+18678


--
PHP Notes Mailing List (http://www.php.net/)
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]





Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread Egon Schmid

From: James Cox [EMAIL PROTECTED]

 I have deleted this note, but it may be worth discussing...

 -Original Message-
 From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
 Sent: Thursday, January 31, 2002 10:10 AM
 To: [EMAIL PROTECTED]
 Subject: [PHP-NOTES] note 18678 added to index


 A suggestion for the manual pages:
 It's time to categorize them into higher-level sections, e.g.
built-in
 modules, communication modules, db modules, security modules,
graphics
 modules etc. Even as an experienced user, I find it difficult to
locate the
 right section now. New users must be totally confused. Thank you.
 --
 http://www.php.net/manual/en/index.php
 http://master.php.net/manage/user-notes.php?action=edit+18678
 http://master.php.net/manage/user-notes.php?action=delete+18678
 http://master.php.net/manage/user-notes.php?action=reject+18678

This was discussed several times. It is easier to categorize the
modules with DocBook 4.

-Egon




RE: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread James Cox

docbook4, which we're converting to, right?

james

 -Original Message-
 From: Egon Schmid [mailto:[EMAIL PROTECTED]]
 Sent: Thursday, January 31, 2002 4:50 PM
 To: James Cox; phpdoc
 Subject: Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index
 
 
 From: James Cox [EMAIL PROTECTED]
 
  I have deleted this note, but it may be worth discussing...
 
  -Original Message-
  From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
  Sent: Thursday, January 31, 2002 10:10 AM
  To: [EMAIL PROTECTED]
  Subject: [PHP-NOTES] note 18678 added to index
 
 
  A suggestion for the manual pages:
  It's time to categorize them into higher-level sections, e.g.
 built-in
  modules, communication modules, db modules, security modules,
 graphics
  modules etc. Even as an experienced user, I find it difficult to
 locate the
  right section now. New users must be totally confused. Thank you.
  --
  http://www.php.net/manual/en/index.php
  http://master.php.net/manage/user-notes.php?action=edit+18678
  http://master.php.net/manage/user-notes.php?action=delete+18678
  http://master.php.net/manage/user-notes.php?action=reject+18678
 
 This was discussed several times. It is easier to categorize the
 modules with DocBook 4.
 
 -Egon
 
 



Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread Mark Kronsbein



James Cox wrote:
 
 docbook4, which we're converting to, right?

right.

Mark

-- 
German Gabber Network @ http://www.gabber.de
Infos und Tips zu PHP http://www.php-homepage.de




Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread Hartmut Holzgraefe

James Cox wrote:
 I have deleted this note, but it may be worth discussing...
 
 A suggestion for the manual pages:
 It's time to categorize them into higher-level sections, e.g. built-in
 modules, communication modules, db modules, security modules, graphics
 modules etc. Even as an experienced user, I find it difficult to locate the
 right section now. New users must be totally confused. Thank you.

see the TODO file


   - group and organize functions logically (databases, text proc, etc)
 (better support for that in docbook4)
 Needs more *discussion*:
   - maybe also group them on folder level, not just in TOC
   - maybe spread configure options, ini settings and
 features to these groups [in TOC and/or in folders]
   - add indexes of options, settings and features if
 previous change goes through


(which reminds me of something i had on my schedule for last saturday :(

-- 
Hartmut Holzgraefe  [EMAIL PROTECTED]  http://www.six.de  +49-711-99091-77

Wir stellen für Sie aus auf der CeBIT 2002 und freuen uns
in Halle 6 auf Ihren Besuch am Stand H 18




Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread Egon Schmid

From: Mark Kronsbein [EMAIL PROTECTED]

 James Cox wrote:
 
  docbook4, which we're converting to, right?

 right.

Right. I am waiting for Hartmut who have more experience with
DocBook 4 than I. The HowTo would IMHO be a good place to publish
all steps for the the change from DocBook 3 to 4.

-Egon




RE: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread James Cox



 Right. I am waiting for Hartmut who have more experience with
 DocBook 4 than I. The HowTo would IMHO be a good place to publish
 all steps for the the change from DocBook 3 to 4.

HOWTO would be a good place to describe 3  4 changes, but also could use an
upgrade ;)

james




Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread Simone Cortesi

At 17.56 31/01/02 +0100, Mark Kronsbein wrote:

James Cox wrote:
 
  docbook4, which we're converting to, right?

right.

When will the change actually happen?

Thanks,
Simone.

-- 
All that is gold does not glitter; not all those that wander
are lost. -- J.R.R. Tolkien, author.




Re: [PHP-DOC] FW: [PHP-NOTES] note 18678 added to index

2002-01-31 Thread Mark Kronsbein

 When will the change actually happen?

AFAIK, Hartmut wants to test some stuff before switching to
DocBook 4. I dont know, when he will be finishes, but I dont 
think that it will be before the weekend.

Mark

-- 
German Gabber Network @ http://www.gabber.de
Infos und Tips zu PHP http://www.php-homepage.de