Compilation of Git Clone copy of Secure Coding Handbook

[Tristan Santore]

On 19/09/13 14:39, Tristan Santore wrote:
> Dear All,
> 
> 
> I am trying to compile the docs, however I get:
> 
> 
> make build-manualmkdir -p en-US/snippets
> python scripts/split-snippets.py . \
>   src/*.c src/*.cpp src/*.java src/*.py
> publican build --formats=html,epub,pdf --langs=en-US
> Setting up en-US
> 	Processing file tmp/en-US/xml/Common_Content/Conventions.xml ->
> tmp/en-US/xml/Common_Content/Conventions.xml
> 	Processing file tmp/en-US/xml/Common_Content/Feedback.xml ->
> tmp/en-US/xml/Common_Content/Feedback.xml
> 	Processing file tmp/en-US/xml/Common_Content/Legal_Notice.xml ->
> tmp/en-US/xml/Common_Content/Legal_Notice.xml
> 	Processing file tmp/en-US/xml_tmp/Author_Group.xml ->
> tmp/en-US/xml/Author_Group.xml
> 	Processing file tmp/en-US/xml_tmp/Book_Info.xml ->
> tmp/en-US/xml/Book_Info.xml
> 	Processing file tmp/en-US/xml_tmp/C-Allocators.xml ->
> tmp/en-US/xml/C-Allocators.xml
> 	Processing file tmp/en-US/xml_tmp/C-Language.xml ->
> tmp/en-US/xml/C-Language.xml
> 	Processing file tmp/en-US/xml_tmp/C-Libc.xml -> tmp/en-US/xml/C-Libc.xml
> *WARNING: Unvalidated tag: 'informalexample'. This tag may not be
> displayed correctly, may generate invalid xhtml, or may breach Section
> 508 Accessibility standards.
> 	Processing file tmp/en-US/xml_tmp/C-Other.xml -> tmp/en-US/xml/C-Other.xml
> 	Processing file tmp/en-US/xml_tmp/C.xml -> tmp/en-US/xml/C.xml
> 	Processing file tmp/en-US/xml_tmp/CXX-Language.xml ->
> tmp/en-US/xml/CXX-Language.xml
> 	Processing file tmp/en-US/xml_tmp/CXX-Std.xml -> tmp/en-US/xml/CXX-Std.xml
> 	Processing file tmp/en-US/xml_tmp/CXX.xml -> tmp/en-US/xml/CXX.xml
> 	Processing file tmp/en-US/xml_tmp/Defensive_Coding.xml ->
> tmp/en-US/xml/Defensive_Coding.xml
> 	Processing file tmp/en-US/xml_tmp/Features-Authentication.xml ->
> tmp/en-US/xml/Features-Authentication.xml
> 	Processing file tmp/en-US/xml_tmp/Features-TLS.xml ->
> tmp/en-US/xml/Features-TLS.xml
> 	Processing file tmp/en-US/xml_tmp/Java-Language.xml ->
> tmp/en-US/xml/Java-Language.xml
> 	Processing file tmp/en-US/xml_tmp/Java-LowLevel.xml ->
> tmp/en-US/xml/Java-LowLevel.xml
> 	Processing file tmp/en-US/xml_tmp/Java-SecurityManager.xml ->
> tmp/en-US/xml/Java-SecurityManager.xml
> 	Processing file tmp/en-US/xml_tmp/Java.xml -> tmp/en-US/xml/Java.xml
> 	Processing file tmp/en-US/xml_tmp/Python.xml -> tmp/en-US/xml/Python.xml
> 	Processing file tmp/en-US/xml_tmp/Revision_History.xml ->
> tmp/en-US/xml/Revision_History.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Cryptography.xml ->
> tmp/en-US/xml/Tasks-Cryptography.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Descriptors.xml ->
> tmp/en-US/xml/Tasks-Descriptors.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-File_System.xml ->
> tmp/en-US/xml/Tasks-File_System.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Library_Design.xml ->
> tmp/en-US/xml/Tasks-Library_Design.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Locking.xml ->
> tmp/en-US/xml/Tasks-Locking.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Processes.xml ->
> tmp/en-US/xml/Tasks-Processes.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Serialization.xml ->
> tmp/en-US/xml/Tasks-Serialization.xml
> 	Processing file tmp/en-US/xml_tmp/Tasks-Temporary_Files.xml ->
> tmp/en-US/xml/Tasks-Temporary_Files.xml
> 	Processing file tmp/en-US/xml_tmp/Web_Applications.xml ->
> tmp/en-US/xml/Web_Applications.xml
> 
> not well-formed (invalid token) at line 46, column 43, byte 2693:
> 
> Won't be escaped (DON'T DO THIS!)
> <h:outputText value="#{param.name}" escape=false>
> ==========================================^
> </code>
> 
>  at /usr/lib64/perl5/vendor_perl/XML/Parser.pm line 187.
> make: *** [build-manual] Error 255
> 
> 
> 
> 
> Also, may I suggest that we add that the dependencies publican,
> publican-fedora as requisites for compilation into the README ?
> 
> 
> Thank you.
> 
> 
> Regards,
> 
> Tristan
> 
> 
> 
Nevermind, used the 1.1.1 tagged Copy.

Still be nice, if we could add the prerequisites into the README though.
Not everyone is accustomed to publican. Also, I am using make
build-manual, so maybe we should add that to the README too, in a
prominent way.

Thank you.

Regards,

Tristan

-- 

Tristan Santore BSc MBCS
TS4523-RIPE
Network and Infrastructure Operations
InterNexusConnect
Mobile +44-78-55069812
Tristan.Santore at internexusconnect.net

Former Thawte Notary
(Please note: Thawte has closed its WoT programme down,
and I am therefore no longer able to accredit trust)

For Fedora related issues, please email me at:
TSantore at fedoraproject.org