Hey folks,
I don't know if anyone mentioned this, but if your Namespaces are long, for example.
MyCompany.MyGroup.CommonLibraries.MyProject
When the CHM file is built, the text of these namespaces will be truncated on the Namespaces page of the resulting help file.
Thanks!
G
Yes. I created an additional XML comment file for project level and namespace level documentation, as described in other threads here. Then after building the CHM from Sandcastle, that documentation displays very well, except for the truncation of long Namespaces in the "Namespaces" section of the Project documentation page. It's like the HTML table being generated for this section is using fixed column widths and not respecting the possibility of longer name strings.
Thanks!
G
Hi George,
The width of the name column (as a fraction of the screen) is indeed fixed. This is by design, as (1) the inconsistancy of varying auto-layouts of the same information can be jarring and (2) we expect that finished documentation will have meaningful namespace descriptions, which would cause the table to have similiar auto-layout column widths anyway. In any case, if you want to change this effect, a small tweak to the CSS file will do the trick.
David
May I suggest then, that you allow the Namespace text to wrap in the cell instead of truncate. It will make the doc more readable without any crazy table layouts.
Thanks!!
-George
