<?xml version="1.0" encoding="UTF-8"?> <!-- Syntax highlighting definition for Unified Parallel C xslthl - XSLT Syntax Highlighting http://sourceforge.net/projects/xslthl/ Copyright (C) 2005-2008 Michal Molhanec, Jirka Kosek, Michiel Hendriks, Viraj Sinha This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution. Michal Molhanec <mol1111 at users.sourceforge.net> Jirka Kosek <kosek at users.sourceforge.net> Michiel Hendriks <elmuerte at users.sourceforge.net> --> <!-- This file is a modified version of c-hl.xml adapted for UPC compatability by , who in no way takes credit for the original creation of this file or the rest of xslthl. --> <highlighters> <highlighter type="multiline-comment"> <start>/**</start> <end>*/</end> <style>doccomment</style> </highlighter> <highlighter type="oneline-comment"> <start><![CDATA[/// ]]></start> <style>doccomment</style> </highlighter> <highlighter type="multiline-comment"> <start>/*</start> <end>*/</end> </highlighter> <highlighter type="oneline-comment">//</highlighter> <highlighter type="oneline-comment"> <!-- use the online-comment highlighter to detect directives --> <start>#</start> <lineBreakEscape>\</lineBreakEscape> <style>directive</style> <solitary /> </highlighter> <highlighter type="string"> <string>"</string> <escape>\</escape> </highlighter> <highlighter type="string"> <string>'</string> <escape>\</escape> </highlighter> <highlighter type="hexnumber"> <prefix>0x</prefix> <suffix>ul</suffix> <suffix>lu</suffix> <suffix>u</suffix> <suffix>l</suffix> <ignoreCase /> </highlighter> <highlighter type="number"> <point>.</point> <pointStarts /> <exponent>e</exponent> <suffix>ul</suffix> <suffix>lu</suffix> <suffix>u</suffix> <suffix>f</suffix> <suffix>l</suffix> <ignoreCase /> </highlighter> <highlighter type="keywords"> <keyword>auto</keyword> <keyword>_Bool</keyword> <keyword>break</keyword> <keyword>case</keyword> <keyword>char</keyword> <keyword>_Complex</keyword> <keyword>const</keyword> <keyword>continue</keyword> <keyword>default</keyword> <keyword>do</keyword> <keyword>double</keyword> <keyword>else</keyword> <keyword>enum</keyword> <keyword>extern</keyword> <keyword>float</keyword> <keyword>for</keyword> <keyword>goto</keyword> <keyword>if</keyword> <keyword>_Imaginary</keyword> <keyword>inline</keyword> <keyword>int</keyword> <keyword>long</keyword> <keyword>register</keyword> <keyword>relaxed</keyword> <keyword>restrict</keyword> <keyword>return</keyword> <keyword>shared</keyword> <keyword>strict</keyword> <keyword>short</keyword> <keyword>signed</keyword> <keyword>sizeof</keyword> <keyword>static</keyword> <keyword>struct</keyword> <keyword>switch</keyword> <keyword>typedef</keyword> <keyword>union</keyword> <keyword>unsigned</keyword> <keyword>upc_blocksizeof</keyword> <keyword>upc_elemsizeof</keyword> <keyword>upc_localsizeof</keyword> <keyword>upc_lock_t</keyword> <keyword>upc_forall</keyword> <keyword>upc_barrier</keyword> <keyword>upc_wait</keyword> <keyword>upc_notify</keyword> <keyword>upc_fence</keyword> <keyword>void</keyword> <keyword>volatile</keyword> <keyword>while</keyword> </highlighter> </highlighters>
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#1 | 12728 | eedwards |
Upgrade ANT doc build infrastructure to assemble PDFs: - remove non-namespaced DocBook source and add namespaced DocBook source. - add Apache FOP 1.1 - copy fonts, images, XSL into _build, establishing new asset structure. The original structure remains until all guides using it can be upgraded, and several other issues can be resolved. - updated build.xml to allow for per-target build properties. - upgraded the P4SAG to use the new infrastructure. - tweaked admonition presentation in PDFs to remove admonition graphics, and resemble closely the presentation used in the new HTML layout, including the same colors. With these changes, building PDFs involves using a shell, navigating into the guide's directory (just P4SAG for now), and executing "ant pdf". Issues still to be resolved: - PDF generation encounters several warnings about missing fonts (bold versions of Symbol and ZapfDingbats), and a couple of locations where the page content exceeds the defined content area. - Due to issues within Apache FOP, PDF generation emits a substantial amount of output that is not easily suppressed without losing important warning information. - Apache FOP's interface to ANT does not expose a way to set the font base directory. The current configuration does work under Mac OSX, but further testing on Windows will need to be done to determine if the relative paths defined continue to work. The workaround is for Windows users to customize the fop-config.xml to provide absolute system paths to the required fonts. - HTML generation needs further browser testing, and exhibits broken navigation on iOS browsers within the TOC sidebar. - A number of PDF and HTML presentation tweaks still need to be made, for example: sidebars, gui* DocBook tags, whitespace, section separation, etc. |