Re: Streams API docs: where to put?

From: Date: Sat, 10 Aug 2002 22:36:07 +0000
Subject: Re: Streams API docs: where to put?
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969347971@lists.php.net to get a copy of this message
OK, so I've put the files under en/chapters and added &chapters.streams; on the line after the zend toc in manual.xml.in. I'm just testing my doc build before I add and commit. Now, I've got a little patch for phpdoc which allows you to specify (using a configure option: --with-htmlcss=URL), a CSS file to include in the generated HTML: the patch is inlined below; if there are no objections, can I commit it? --Wez. wez@zaneeb:~/src/php/phpdoc > cvs diff configure.in Index: configure.in =================================================================== RCS file: /repository/phpdoc/configure.in,v retrieving revision 1.172 diff -u -w -B -b -r1.172 configure.in --- configure.in 7 Aug 2002 12:33:10 -0000 1.172 +++ configure.in 10 Aug 2002 22:30:24 -0000 @@ -395,6 +395,22 @@ dnl }}} +dnl {{{ +AC_MSG_CHECKING(for CSS to use for html docs) +AC_ARG_WITH(htmlcss, +[ --with-htmlcss=URL Specify a CSS file to include in html docs], +[ + AC_MSG_RESULT([$withval]) + HTMLCSS="(define %stylesheet% \"$withval\")" +],[ + HTMLCSS="" + AC_MSG_RESULT([none]) +]) + +AC_SUBST(HTMLCSS) + +dnl }}} + dnl {{{ enable Windows HTML Help only pages in build AC_MSG_CHECKING(for chmonly inclusion) wez@zaneeb:~/src/php/phpdoc > cvs diff dsssl/html.dsl.in Index: dsssl/html.dsl.in =================================================================== RCS file: /repository/phpdoc/dsssl/html.dsl.in,v retrieving revision 1.1 diff -u -w -B -b -r1.1 html.dsl.in --- dsssl/html.dsl.in 6 Jan 2002 15:42:27 -0000 1.1 +++ dsssl/html.dsl.in 10 Aug 2002 22:30:45 -0000 @@ -21,6 +21,7 @@ (define %html-ext% ".html") (define %output-dir% "html") +@HTMLCSS@ &html-common.dsl; &html-locale.dsl; On 08/10/02, "Rasmus Lerdorf" <rasmus@php.net> wrote: > I don't see any problems just putting it into the manual as a separate > chapter following the ZendAPI chapter. > > At the moment, I have them under en/appendices like this: > > > > streams.xml > > streams.common.xml > > streams.constants.xml > > streams.dir.xml > > streams.file.xml > > streams.socket.xml > > streams.structs.xml

« previous php.doc (#969347971) next »