[PHP-DOC] Patching phd.bat and wrapping --help output at 80 characters for Windows

2009-02-20 Thread Nicholas Sloan
I corrected the line endings in phd.bat to be Windows style 
line-endings, since that file is used by Windows only.


I also edited PhDBuildOptions.class.php to limit the output of --help to 
no more than 80 characters per line so that it will display correctly in 
command.exe on Windows.


This is my first time submitting a patch, so if I screwed something up, 
let me know.


-Nick

Index: phd.bat
===
RCS file: /repository/phd/phd.bat,v
retrieving revision 1.3
diff -u -r1.3 phd.bat
--- phd.bat2 Dec 2008 21:27:09 -1.3
+++ phd.bat20 Feb 2009 22:02:52 -
@@ -1,4 +1,4 @@
-...@echo off
-REM $Id: phd.bat,v 1.3 2008/12/02 21:27:09 kalle Exp $
-
-@@php_bin@ @bin_...@\build.php %*
+...@echo off
+REM $Id: phd.bat,v 1.3 2008/12/02 21:27:09 kalle Exp $
+
+@@php_bin@ @bin_...@\build.php %*
Index: include/PhDBuildOptions.class.php
===
RCS file: /repository/phd/include/PhDBuildOptions.class.php,v
retrieving revision 1.12
diff -u -r1.12 PhDBuildOptions.class.php
--- include/PhDBuildOptions.class.php16 Feb 2009 20:34:13 -1.12
+++ include/PhDBuildOptions.class.php20 Feb 2009 22:02:52 -
@@ -350,21 +350,27 @@
   -t themename
   --theme themenameThe theme to use
   -I
-  --noindex  Do not index before rendering but load 
from cache (false)
+  --noindex  Do not index before rendering but load 
from cache

+ (default: false)
   -d filename
   --docbook filename   The Docbook file to render from
   -p id[=bool]
-  --partial id[=bool]  The ID to render, optionally skipping its 
children chunks (default to true; render children)
+  --partial id[=bool]  The ID to render, optionally skipping its 
children

+ chunks (default to true; render children)
   -s id[=bool]
-  --skip id[=bool] The ID to skip, optionally skipping its 
children chunks (default to true; skip children)
+  --skip id[=bool] The ID to skip, optionally skipping its 
children

+ chunks (default to true; skip children)
   -l formats/themes
-  --list formats/themesPrint out the supported formats/themes 
(default: both)

+  --list formats/themesPrint out the supported formats/themes
+ (default: both)
   -o directory
   --output directory   The output directory (default: .)
   -L language
-  --lang language  The language of the source file (used by 
the CHM theme). (default: en
+  --lang language  The language of the source file (used by 
the CHM

+ theme). (default: en)
   -c bool
-  --color bool Enable color output when output is to a 
terminal (default: false)
+  --color bool Enable color output when output is to a 
terminal

+ (default: false)
   -g classname
   --highlighter classname  Use custom source code highlighting php class
   -V

Index: phd.bat
===
RCS file: /repository/phd/phd.bat,v
retrieving revision 1.3
diff -u -r1.3 phd.bat
--- phd.bat 2 Dec 2008 21:27:09 -   1.3
+++ phd.bat 20 Feb 2009 22:02:52 -
@@ -1,4 +1,4 @@
-...@echo off
-REM $Id: phd.bat,v 1.3 2008/12/02 21:27:09 kalle Exp $
-
-@@php_bin@ @bin_...@\build.php %*
+...@echo off
+REM $Id: phd.bat,v 1.3 2008/12/02 21:27:09 kalle Exp $
+
+@@php_bin@ @bin_...@\build.php %*
Index: include/PhDBuildOptions.class.php
===
RCS file: /repository/phd/include/PhDBuildOptions.class.php,v
retrieving revision 1.12
diff -u -r1.12 PhDBuildOptions.class.php
--- include/PhDBuildOptions.class.php   16 Feb 2009 20:34:13 -  1.12
+++ include/PhDBuildOptions.class.php   20 Feb 2009 22:02:52 -
@@ -350,21 +350,27 @@
   -t themename
   --theme themenameThe theme to use
   -I
-  --noindex  Do not index before rendering but load from cache 
(false)
+  --noindex  Do not index before rendering but load from cache
+ (default: false)
   -d filename
   --docbook filename   The Docbook file to render from
   -p id[=bool]
-  --partial id[=bool]  The ID to render, optionally skipping its 
children chunks (default to true; render children)
+  --partial id[=bool]  The ID to render, optionally skipping its children
+ chunks (default to true; render children)
   -s id[=bool]
-  --skip id[=bool] The ID to skip, optionally skipping its children 
chunks (default to true; skip children)
+  --skip id[=bool] The ID to skip, optionally skipping its children
+ chunks (default to true; skip children)
   -l formats/themes
-  --list formats/themesPrint out the supported formats/themes (default: 

[PHP-DOC] Summer of Code Introduction

2008-04-22 Thread Nicholas Sloan
Hi, my name is Nicholas Sloan and I was selected to participate in this 
year's Summer of Code program for the PHP project. Hannes Magnusson will 
be mentoring me as I work on PhD (The PHP Based Docbook Renderer). I'm 
excited to be working on the docs, since I feel that great documentation 
 can be the most welcoming thing to a new programming language for most 
users. The only thing that might be important is the community, but 
PHP's community certainly doesn't need any help at being great.


In any case, I look forward to working with everyone and getting to know 
you all this summer. If you have any questions, feel free to ask any time.


For those of you that are interested, here is a link to my project abstract:
http://code.google.com/soc/2008/php/appinfo.html?csaid=74121AFCC0C7C341

And here is a link to my project proposal:
http://nicholassloan.com/public/gsoc.pdf

Regards,

Nicholas Sloan