[erlang-questions] Trouble with 'make docs'

[Richard O'Keefe]

fop -fo ../pdf/asn1-1.7.fo -pdf ../pdf/asn1-1.7.pdf
Jun 8, 2012 11:33:42 AM org.apache.fop.events.LoggingEventListener processEvent
WARNING: Line 1 of a paragraph overflows the available area by more than 50 points. (See position 3001:226)

Lots more of those.

(cd ../../java_src;javadoc -sourcepath . -d ../doc/html/java \
                -windowtitle 'Java-Erlang Interface Library' com.ericsson.otp.erlang)
Creating destination directory: "../doc/html/java/"
Loading source files for package com.ericsson.otp.erlang...
Constructing Javadoc information...
./com/ericsson/otp/erlang/._OtpCookedConnection.java:1: illegal character: \0
Mac OS X                2°âATTR'Ü2â˜&˜&com.apple.quarantine0000;4fd01bab;Safari;|com.apple.SafariThis resource fork intentionally left blank   ÿÿ
^
./com/ericsson/otp/erlang/._OtpCookedConnection.java:1: illegal character: \5
Mac OS X                2°âATTR'Ü2â˜&˜&com.apple.quarantine0000;4fd01bab;Safari;|com.apple.SafariThis resource fork intentionally left blank   ÿÿ
 ^

Lots more of those.
When you download and unpack something, Mac OS X helpfully
creates a resource fork that basically says "don't trust this".
Just opening a file creates a long slow bounce that eventually
pops up a dialogue box saying "this is an application that came
from the net, do you really want to run it" when all you are
doing is trying to view a text file with an editor.  The
convention is that foo.bar gets an associated "._foo.bar"
which must for most purposes be ignored.  If there's any way to
stop these files being created, I don't know what it is.
Some Makefile could do
	find . -name '[.]_*' -exec rm "{}" +

Standard Doclet version 1.6.0_31
Building tree for all the packages and classes...
Generating ../doc/html/java/com/ericsson/otp/erlang//AbstractConnection.html...
/home/cshome/o/ok/Downloads/otp_src_R15B01/lib/jinterface/java_src/./com/ericsson/otp/erlang/AbstractConnection.java:276: warning - @param argument "msg" is not a parameter name.

Generating ../doc/html/java/com/ericsson/otp/erlang//OtpConnection.html...
/home/cshome/o/ok/Downloads/otp_src_R15B01/lib/jinterface/java_src/./com/ericsson/otp/erlang/OtpConnection.java:414: warning - @param argument "msg" is not a parameter name.

A couple more like that.

Generating ../doc/html/java/com/ericsson/otp/erlang//OtpErlangString.html...
/home/cshome/o/ok/Downloads/otp_src_R15B01/lib/jinterface/java_src/./com/ericsson/otp/erlang/OtpErlangString.java:53: warning - Tag @return cannot be used in constructor documentation.  It can only be used in the following types of documentation: method.

All of these resulted in 'make docs' being derailed part way through.

I don't believe anyone can ever have built the docs on a Mac from a
download without running into these problems.