Re: Open Letter to Christian

Let me give your scripts/howto a whirl and we will go from there. Steph's email about dependencies is gonna be an issue, but if I have a list of what those dependencies exactly are it shouldn't be too hard to work up an autoconf script to handle that (Andrei's big concern). Andrei gave me a list of requirements for the docs that he sees necessary to get them up on gtk.php.net. Unfortunately I don't have those on me at the moment, but I will try and get those sent off by tomorrow (since I leave Friday morning for Frankfurt). I land in Frankfurt at noon on Saturday and will be available to meet with anyone who wants to meet any time between then and Wednesday evening (I leave for Rome before dawn on Thursday, so won't be up super late on Wed). -Jeremy On 11/2/05, Christian Weiske <cweiske@cweiske.de> wrote: > Jeremy, > > > > I apologize for having to call this out in public, but I can't get a > > response to my emails to you. > Never got one :/ My spamfilter tells me there were none in the last 3 days. > > > What I am needing is a list of changes (in as > > much detail as possible) > - Restructured the whole directory: > - manual files aren't directly in the root any more, there is a > manual/ dir with the base files and all language dirs beneath it > - There are an example/ and an images/ directory with - examples and > images > - no utf-8 dir any more. All doc files have to be written in utf-8, so > there's no need to convert them. > - Stylesheets have changed internally, but nothing you'd see from > outside. > - the build/ dir still has language subdirs, and below them are the > "type" subdirs (html, phpweb, ...) > - phpweb won't work from the start; at least I haven't tried it yet > - there are no config and no make files any more; I don't like them > and I don't know how to make them. You volunteered to do them some > months ago, but you missed it, right? However, there is a > gen_manual.sh file which does all that. Just call it without any > params, and it will show you some help. > - There is a runfirst.sh script you'll need to run first > - build files (at least html ones) are distributed over several > directories after compilation has finished. That makes browsing the > dirs much more easy, because there aren't 2000+ files in one dir > any more. > - I wrote a "doc compilation" howto: > > http://docs.crisscott.com/php-gtk/tutorials/tutorials.doccing.checkout.html > > We can talk at the php lounge tuesday evening, ok? > > > > > which you made between the old style docs and the > > new style docs. I know you sent out an email about it a while back (like 6 > > months ago), but I can't seem to find it. > > http://marc.theaimsgroup.com/?l=php-gtk-doc&m=111316563116664&w=2 > was at gtk.php.net home page :) > > > automated building of the docs to happen like it did before (so we can have > > them hosted on gtk.php.net <http://gtk.php.net>), > > but without knowing > > everything you changed (file system structure, build settings, etc) it is > > rather difficult. > I use the following script: > kindergarten@dojo ~ $ cat /data/Programming/php-gtk2-doc/recompile_docs.sh > #!/bin/sh > # checkout or update php-gtk-doc and compile it > # for cweiske.dyndns.org > > cd "dirname "$0"" > echo "Updating php-gtk-doc from CVS" > if [ ! -d php-gtk-doc ]; then > #does not exist - check out > cvs -d :pserver:cvsread@cvs.php.net:/repository co -P php-gtk-doc > cd php-gtk-doc > #init > ./runfirst.sh > else > #does exist - update > cd php-gtk-doc > cvs -d :pserver:cvsread@cvs.php.net:/repository update -Pd > fi > > echo "Done updating from CVS, generating manual" > ./runfirst.sh > ./gen_manual.sh en html > > echo "Moving generated manual to apache document directory" > #we're in php-gtk-doc directory > #move to /data/Programming/apache/php-gtk2-doc > rm -r /data/Programming/apache/php-gtk2-doc/* > mv build/* /data/Programming/apache/php-gtk2-doc/ > > echo "AddDefaultCharset UTF-8" > > /data/Programming/apache/php-gtk2-doc/.htaccess > > > -- > Regards/MfG, > Christian Weiske > > > -- --------------------------- Jeremy Johnstone http://www.jeremyjohnstone.com jsjohnst@php.net