Re: Open Letter to Christian
| From: | Christian Weiske | Date: | Thu, 03 Nov 2005 05:56:56 +0000 |
| Subject: | Re: Open Letter to Christian | ||
| References: | 1 | Groups: | php.gtk.dev |
| Request: | Send a blank email to php-gtk-dev+get-2046@lists.php.net to get a copy of this message | ||
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 "
Attachment: [application/pgp-signature] OpenPGP digital signature signature.asc
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
Attachment: [application/pgp-signature] OpenPGP digital signature signature.asc