Bug 192858

Summary: [porters-handbook] make lint failure
Product: Documentation Reporter: Enji Cooper <ngie>
Component: Books & ArticlesAssignee: Mathieu Arnold <mat>
Status: Closed Overcome By Events    
Severity: Affects Many People CC: doc
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

Description Enji Cooper freebsd_committer freebsd_triage 2014-08-20 16:22:40 UTC 
# svn info
Path: .
Working Copy Root Path: /root/freebsd-doc
URL: svn+ssh://ngie@svn.freebsd.org/doc/head
Relative URL: ^/head
Repository Root: svn+ssh://ngie@svn.freebsd.org/doc
Repository UUID: c2e8774f-c49f-e111-b436-862b2bbc8956
Revision: 45483
Node Kind: directory
Schedule: normal
Last Changed Author: ache
Last Changed Rev: 45483
Last Changed Date: 2014-08-20 08:52:37 -0700 (Wed, 20 Aug 2014)
# svn status
M       en_US.ISO8859-1/articles/committers-guide/article.xml
?       en_US.ISO8859-1/books/porters-handbook/book.parsed.xml
?       en_US.ISO8859-1/books/porters-handbook/freebsd.sch.xsl
# make lint
...
===> en_US.ISO8859-1/books/porters-handbook (lint)
env XML_CATALOG_FILES="file:///root/freebsd-doc/head/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml  file:///root/freebsd-doc/head/en_US.ISO8859-1/share/xml/catalog.xml  file:///root/freebsd-doc/head/share/xml/catalog.xml  file:///root/freebsd-doc/head/share/xml/catalog-common.xml  file:///usr/local/share/xml/catalog" /usr/local/bin/xsltproc --param allow-foreign "true" /usr/local/share/xsl/iso-schematron/xslt1/iso_schematron_skeleton_for_xslt1.xsl /root/freebsd-doc/head/share/xml/freebsd.sch > freebsd.sch.xsl
==> Basic validation
==> Validating with Schematron constraints
example must not occur in the descendants of table
*** Error code 1

Stop.
make[3]: stopped in /root/freebsd-doc/head/en_US.ISO8859-1/books/porters-handbook
*** Error code 1

Stop.
make[2]: stopped in /root/freebsd-doc/head/en_US.ISO8859-1/books
*** Error code 1

Stop.
make[1]: stopped in /root/freebsd-doc/head/en_US.ISO8859-1
*** Error code 1

Stop.
make: stopped in /root/freebsd-doc/head
Comment 1 Mathieu Arnold freebsd_committer freebsd_triage 2014-08-20 20:50:03 UTC 
Mmm, as I'm the one who wrote that bit, I think that should be allowed, no reason to forbit it, the reported problem is the uses chapter:

https://www.freebsd.org/doc/en/books/porters-handbook/uses.html

which is a big table with examples in it :-)
Comment 2 Mathieu Arnold freebsd_committer freebsd_triage 2015-07-21 13:50:00 UTC 
currently being worked on by removing the table https://reviews.freebsd.org/D3142
Comment 3 Mathieu Arnold freebsd_committer freebsd_triage 2015-07-27 15:34:50 UTC 
section was rewritten.  Note that there are other lint errors, that are not likely to be fixed.