Skip to contentSkip to conversation

updated xfs documentation available

ANNOUNCE Eric Sandeen 2 participants 3 messages Aug 23, 2010

lore
Share & tools
lore
#0 lore raw

Just as an FYI, we've converted some of the older SGI XFS documentation to XML/Docbook/Publican[1] format, and it's now available on xfs.org; see
http://xfs.org/index.php/XFS_Papers_and_Documentation

particularly the 3 links at the top,

* XFS User Guide

* XFS File System Structure

* XFS Training Labs

In addition to the XML conversion, much of the documentation has been updated & corrected compared to the original docs.

This should be good material for anyone using, developing, or supporting XFS. If omissions or errors are found, we'd be happy to accept patches against the XML source for the docs, found at
http://git.kernel.org/?p=fs/xfs/xfsdocs-xml-dev.git;a=summary

In addition, using that git repo + publican allows one to create the documentation in various other forms such as PDFs, txt, and epub.

Thanks!

-Eric

[1] https://fedorahosted.org/publican/

_______________________________________________
xfs mailing list
[email protected]
http://oss.sgi.com/mailman/listinfo/xfs

#1 lore raw
Quoted 11 lines

Just as an FYI, we've converted some of the older SGI XFS documentation to XML/Docbook/Publican[1] format, and it's now available on xfs.org; see
http://xfs.org/index.php/XFS_Papers_and_Documentation

particularly the 3 links at the top,

* XFS User Guide

* XFS File System Structure

I am not sure about the other guides, but the images in the html output are being sized down making them not-so-readable. Eg,
http://xfs.org/docs/xfsdocs-xml-dev/XFS_Filesystem_Structure//tmp/en-US/
html/Internal_Inodes.html

Would it be possible to regenerate these with the scaling off?

Thanks,

Quoted 15 lines

* XFS Training Labs

In addition to the XML conversion, much of the documentation has been updated & corrected compared to the original docs.

This should be good material for anyone using, developing, or supporting
XFS. If omissions or errors are found, we'd be happy to accept patches against the XML source for the docs, found at
http://git.kernel.org/?p=fs/xfs/xfsdocs-xml-dev.git;a=summary

In addition, using that git repo + publican allows one to create the documentation in various other forms such as PDFs, txt, and epub.

Quoted 5 lines

Thanks!

-Eric

[1] https://fedorahosted.org/publican/

This email communication and any files transmitted with it may contain confidential and or proprietary information and is provided for the use of the intended recipient only. Any review, retransmission or dissemination of this information by anyone other than the intended recipient is prohibited. If you receive this email in error, please contact the sender and delete this communication and any copies immediately. Thank you.
http://www.encana.com

_______________________________________________
xfs mailing list
[email protected]
http://oss.sgi.com/mailman/listinfo/xfs

#2 lore raw
Quoted 12 lines · David
Quoted 11 lines

Just as an FYI, we've converted some of the older SGI XFS documentation to XML/Docbook/Publican[1] format, and it's now available on xfs.org; see
http://xfs.org/index.php/XFS_Papers_and_Documentation

particularly the 3 links at the top,

* XFS User Guide

* XFS File System Structure

Quoted 8 lines

I am not sure about the other guides, but the images in the html output are being sized down making them not-so-readable. Eg,
http://xfs.org/docs/xfsdocs-xml-dev/XFS_Filesystem_Structure//tmp/en-US/
html/Internal_Inodes.html

Would it be possible to regenerate these with the scaling off?

Thanks,

Interesting, I'll have to look into how publican decides to scale images when it generates html... not sure offhand. :)

Thanks,
-Eric

_______________________________________________
xfs mailing list
[email protected]
http://oss.sgi.com/mailman/listinfo/xfs