Re: RFC: Re-organizing function reference part

From: Date: Sun, 26 Aug 2001 17:39:42 +0000
Subject: Re: RFC: Re-organizing function reference part
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969337286@lists.php.net to get a copy of this message
> Can be done without any hurry before the change: > - Modify the *.dsl files so that TOC is created the right way. Some small > fixing with HTML version, a bit more with printable versions. I will > volunteer, unless Hartmut explicitly requests to have the honour... > - New subtitles must be agreed on and added to each language-defs.ent. This is what needs to be the same for the bug system. So if it is not right, we should collect the functions and make a new category system, and start to use it in the bug system and here too. > - I guess that some scripts relating to the online HTML-manual should > be fixed. Not sure though. As long as we can get the file names stay the same, there is nothing [I can think of] to modify in the scripts at phpweb. The notes are binded by file names, so this is why the file names are important for us. > - Probably more... Erm, if we start to change things in a way like that, we can also start paralelly on proofing the "split up the function reference by functions into files" plan. This was a great plan IMHO, and [if we can agree in both cases] we should make the two changes the same time, instead of two separate repository-wide changes. > Can be done only after the re-organization, and with great hurry, because > the change will temporarily break a lot of things: > - Change the tags, and within <abstract>, add <para> tags around <note>s > and <warning>s and change <simpara>s to <para>s, because the DTD > requires this. Maybe somebody can write scripts for these tasks, and test if they are working well (a good place for these scripts is the scripts dir under phpweb :). [See the readme there]. > Comments? I think the ideas are OK, and we can go on discuss this. I am against nothing with this plan this time. Goba

« previous php.doc (#969337286) next »