Bug 444551

Summary: Add support for <entrytbl>
Product: [Community] Publican Reporter: David O'Brien <daobrien>
Component: publicanAssignee: Jeff Fearn <jfearn>
Status: CLOSED WONTFIX QA Contact: Michael Hideo <mhideo>
Severity: low Docs Contact:
Priority: low    
Version: 2.0CC: mmcallis, publican-list
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-04-29 01:15:12 EDT Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:

Description David O'Brien 2008-04-28 22:20:18 EDT
Description of problem:

This tag is used to create nested tables, and currently returns a warning on
make test:
WARNING: Unknown tag: entrytbl. This tag may not be displayed correctly

http://www.docbook.org/tdg/en/html/entrytbl.html

Version-Release number of selected component (if applicable):


How reproducible:


Steps to Reproduce:
1.
2.
3.
  
Actual results:


Expected results:


Additional info:
Comment 1 Jeff Fearn 2008-04-29 01:15:12 EDT
Nested tables cause enormous problems in the PDF output, make debugging and
supporting the tool chain significantly more difficult, and usually reflect poor
content structure. For these reasons this tag will not receive support.

e.g. the table in the IPA release notes would be better layed out with the most
significant factor, the number of entries, on the left hand side:

Num Entries  | RAM   | HDD | CPU
10K - 250K   | 256MB | 2GB | P3
250K - 1M    | 512MB | 4GB | P3
1M+          | 1GB   | 8GB | P3

This removes the table nesting and makes it far more obvious to the reader what
the important factor is for deciding hardware requirements.