On Fri, May 3, 2013 at 1:10 PM, Priyanka Kapoor <
anjalicool.kapoor...@gmail.com> wrote:
> On Fri, May 3, 2013 at 5:16 AM, Clifford Yapp <cliffy...@gmail.com> wrote:
> >
> > Our man pages are written in DocBook - see any of the examples in the
> > directory
> >
> > doc/docbook/system/man1/en
> >
> > in the source tree.
>
> Sir, I made its manual page and tested on brlcad-7.22.0 version.
> Its working fine. Here is screenshot attached:
> http://202.164.53.122/~priyanka/tgf.png
>
> tgf-g.xml file is:
> http://202.164.53.122/~priyanka/tgf-g.xml
>
> One addition of refernce in CMakeLists.txt (tgf-g.xml)
>
> But when I downloaded recent version so making patch, its giving me
> error: Failed to validate.
>
> Can you please tell me the possible cause?
>
We use the tool xmllint to make sure our DocBook pages are fully valid. If
you build your man page and use the VERBOSE flag:
make make tgf-g_man1_html VERBOSE=1
you will see something similar to:
[100%] Validating DocBook source with xmllint:
cd /home/user/brlcad/build/doc/docbook/system/man1/en &&
/usr/local/bin/cmake -P
/home/user/brlcad/build/doc/docbook/system/man1/en/tgf-g_validate.cmake
The script file tgf-g_validate.cmake is what runs xmllint on your xml file
to make sure it is valid.
Hopefully, there is some specific error being generated that tells you why
the validation is failing. Typically the best resource for figuring out
the correct way to do things with DocBook is
http://www.docbook.org/tdg5/en/html/docbook.html - be sure to also check
the doc/docbook/README and doc/docbook/README.DB_authors_notes files to see
if they provide relevant information.
Once you have the man page in valid form, you should submit it to
sourceforge as a patch.
CY
------------------------------------------------------------------------------
Get 100% visibility into Java/.NET code with AppDynamics Lite
It's a free troubleshooting tool designed for production
Get down to code-level detail for bottlenecks, with <2% overhead.
Download for free and get started troubleshooting in minutes.
http://p.sf.net/sfu/appdyn_d2d_ap2
_______________________________________________
BRL-CAD Developer mailing list
brlcad-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/brlcad-devel
