> It would be nice to look at this work from a technical perspective first > (file names, organization, IDs, section titles), so we can fix that up, > and then go on to fix the contents. I have done make test-ing and make > test_xml also found no errors. Here is how to test: > > - edit your local copy of manual.xml.in > -> uncomment the new install part > -> put the old install part and php.ini section into comments > (or otherwise IDs will clash) > > - run configure > > - make test and make text_xml should be fine (although there are > broken links in the manual with this setup due to changed IDs, > but that should only be fixed, if the permanently switch to > this new part) > > - now either build your local HTML copy or use livedocs locally > (maybe someone can even put up an online version of this somwhere)
You also need to modify the line in livedocs.php/index.php: 'installation' => 'install.general', to 'install' => 'handle_appendixes_funcref', > I have not changed manual.xml.in yet, since I beleive it is only viable > if we review the structure and selected IDs at least (so notes can be > moved and links can be corrected within the manual). The on-line manual takes so long to update that you can change the manual.xml.in and then we have two months before the content goes on-line :) But first someone need to correct the huge problem with notes. AFAIK, the Jakub's patch wasn't applied yet (or the master server hasn't updated the CVS...) so we can't move notes. > IMPORTANT: What is gone from the Unix part? > > - Linux specific instructions: only contained a note on using packages > which was integrated to the general unix stuff. Most of the user > notes are server specific, so should be moved to the different > server docs. There are some OS specific notes, which I don't know > of what to do with (move to unix general page?). > > - Apache quick reference: this is not needed anymore IMHO, since we > have more and more places, where a choice need to be made (CLI/CGI, > PHP 4 / PHP 5, etc), so providing a single quick reference is not > possible. > > - section of other servers: only contained two lines of text. User > notes should be moved to the general unix page (will have a lot of > notes there) > > BTW I beleive that we should bring back the other servers page, and we > should link to instructions for servers not covered in the manual, but > dealt with elsewhere. Some user notes will help in this. Then we can > keep the user notes on this page. Otherwise this page is pretty useless. > > If I remember correctly, everything else was taken over to this section... > > Now the xml files are out for reviewers. The sooner you fix my errors, > the sooner we can start reviewing the install sections, so finally can > include a more accurate, better navigable and even more complete install > section. There are a couple of missing ids. I'll try to take a look to the docs today. Nuno
