[armedbear-devel] Pdfdoclet - Javadoc for ABCL in PDF format

Sean Champ spchamp at me.com
Sun Jul 21 09:09:18 UTC 2013


Hello!

In brief: Attached is a shell script for running pdfdoclet[6], a Javadoc 
doclet component that generates PDF format documentation, instead of 
HTML, when used with the javadoc tool. For sake of convenience, I was 
going to send the PDF format ABCL javadoc generated by pdfdoclet, but 
the resulting PDF file is 13.3 megs in size. Maybe the little utility 
shell script, as attached, could be enough.

The PDF javadoc could be useful, i think,  in the interest of studying 
ABCL's Java API - perhaps more intermediately, for modeling ABCL's Java 
API in UML - for instance, using  Modelio[1], Argo[2], or Papyrus[3], on 
the laptop, and Cubetto Mobile[4] on the tablet.

As an additional plug: As far as the PDF format itself, and PDF's 
annotation support, typically on mobile, i tend to prefer Goodreader[5]. 
It offers good support for PDF annotations and so on.


PDFDoclet can also be used from Ant. I'm not very well familiar with 
Ant, offhand. Of course, I notice that Ant is used in ABCL - will take a 
look...


Cheers!


[1] http://www.modeliosoft.com/
[2] http://argouml.tigris.org/
[3] http://www.eclipse.org/papyrus/
[4] http://www.semture.de/en/cubetto-mobile-en/overview
[5] http://www.goodiware.com/goodreader.html
[6] http://pdfdoclet.sourceforge.net/

<http://pdfdoclet.sourceforge.net/><http://www.semture.de/en/cubetto-mobile-en/overview><http://www.eclipse.org/papyrus/> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mailman.common-lisp.net/pipermail/armedbear-devel/attachments/20130721/c83f0155/attachment.html>
-------------- next part --------------
#!/bin/bash

## Shell script for running PDFDoclet from the command line
##
## see javadoc(1), also http://pdfdoclet.sourceforge.net/running.html
##
## Args:
##  1: PDF filename (optional, default javadoc.pdf)
##  2: source directory (optionall, default $PWD)
##  3: list of pacakges to generate documentation for (optional,
##     default is derived based on pathname semantics in the source
##     directory)

THISDIR=$(dirname $(realpath $0))


PDF="${1:-javadoc.pdf}"
shift
#echo PDF=$PDF

SRC="${1:-$PWD}"
shift
#echo SRC=$SRC

if [ -n "$1" ]; then
  PACKAGES="$1"
  shift
else
 PACKAGES="$(find "$SRC" -type d ! -path "*META-INF*" -a ! -path "*WEB-INF*" -printf "\n%P" |
	       sed 's|/|.|g')"
fi
#echo PACKAGES=$PACKAGES


CFG="${1:-$THISDIR/../share/pdfdoclet/default.properties}"
shift
#echo CFG=$CFG


JAVADOC=/usr/bin/javadoc
JAR=${THISDIR}/../share/java/pdfdoclet.jar
DOCLET=com.tarsec.javadoc.pdfdoclet.PDFDoclet

export CLASSPATH=$JAR

exec "${JAVADOC}" -docletpath "${JAR}" -doclet "${DOCLET}" \
    -pdf "${PDF}" -config "${CFG}" -sourcepath "${SRC}" $PACKAGES


More information about the armedbear-devel mailing list