[PATCH] docbook: make a filesystems book

Make a filesystems DocBook book/file by moving all filesystems info from
kernel-api.tmpl. Will also merge journal-api.tmpl into it soon (with
permission from Roger Gammans). Localizes filesystem info and reduces size
of the huge (produced) kernel-api output files.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>

authored by Randy Dunlap and committed by Linus Torvalds bbb5bbb0 351edd24

+102 -61
+1 -1
Documentation/DocBook/Makefile
··· 9 DOCBOOKS := wanbook.xml z8530book.xml mcabook.xml videobook.xml \ 10 kernel-hacking.xml kernel-locking.xml deviceiobook.xml \ 11 procfs-guide.xml writing_usb_driver.xml \ 12 - kernel-api.xml journal-api.xml lsm.xml usb.xml \ 13 gadget.xml libata.xml mtdnand.xml librs.xml rapidio.xml \ 14 genericirq.xml 15
··· 9 DOCBOOKS := wanbook.xml z8530book.xml mcabook.xml videobook.xml \ 10 kernel-hacking.xml kernel-locking.xml deviceiobook.xml \ 11 procfs-guide.xml writing_usb_driver.xml \ 12 + kernel-api.xml filesystems.xml journal-api.xml lsm.xml usb.xml \ 13 gadget.xml libata.xml mtdnand.xml librs.xml rapidio.xml \ 14 genericirq.xml 15
+101
Documentation/DocBook/filesystems.tmpl
···
··· 1 + <?xml version="1.0" encoding="UTF-8"?> 2 + <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 3 + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []> 4 + 5 + <book id="Linux-filesystems-API"> 6 + <bookinfo> 7 + <title>Linux Filesystems API</title> 8 + 9 + <legalnotice> 10 + <para> 11 + This documentation is free software; you can redistribute 12 + it and/or modify it under the terms of the GNU General Public 13 + License as published by the Free Software Foundation; either 14 + version 2 of the License, or (at your option) any later 15 + version. 16 + </para> 17 + 18 + <para> 19 + This program is distributed in the hope that it will be 20 + useful, but WITHOUT ANY WARRANTY; without even the implied 21 + warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 22 + See the GNU General Public License for more details. 23 + </para> 24 + 25 + <para> 26 + You should have received a copy of the GNU General Public 27 + License along with this program; if not, write to the Free 28 + Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, 29 + MA 02111-1307 USA 30 + </para> 31 + 32 + <para> 33 + For more details see the file COPYING in the source 34 + distribution of Linux. 35 + </para> 36 + </legalnotice> 37 + </bookinfo> 38 + 39 + <toc></toc> 40 + 41 + <chapter id="vfs"> 42 + <title>The Linux VFS</title> 43 + <sect1><title>The Filesystem types</title> 44 + !Iinclude/linux/fs.h 45 + </sect1> 46 + <sect1><title>The Directory Cache</title> 47 + !Efs/dcache.c 48 + !Iinclude/linux/dcache.h 49 + </sect1> 50 + <sect1><title>Inode Handling</title> 51 + !Efs/inode.c 52 + !Efs/bad_inode.c 53 + </sect1> 54 + <sect1><title>Registration and Superblocks</title> 55 + !Efs/super.c 56 + </sect1> 57 + <sect1><title>File Locks</title> 58 + !Efs/locks.c 59 + !Ifs/locks.c 60 + </sect1> 61 + <sect1><title>Other Functions</title> 62 + !Efs/mpage.c 63 + !Efs/namei.c 64 + !Efs/buffer.c 65 + !Efs/bio.c 66 + !Efs/seq_file.c 67 + !Efs/filesystems.c 68 + !Efs/fs-writeback.c 69 + !Efs/block_dev.c 70 + </sect1> 71 + </chapter> 72 + 73 + <chapter id="proc"> 74 + <title>The proc filesystem</title> 75 + 76 + <sect1><title>sysctl interface</title> 77 + !Ekernel/sysctl.c 78 + </sect1> 79 + 80 + <sect1><title>proc filesystem interface</title> 81 + !Ifs/proc/base.c 82 + </sect1> 83 + </chapter> 84 + 85 + <chapter id="sysfs"> 86 + <title>The Filesystem for Exporting Kernel Objects</title> 87 + !Efs/sysfs/file.c 88 + !Efs/sysfs/symlink.c 89 + !Efs/sysfs/bin.c 90 + </chapter> 91 + 92 + <chapter id="debugfs"> 93 + <title>The debugfs filesystem</title> 94 + 95 + <sect1><title>debugfs interface</title> 96 + !Efs/debugfs/inode.c 97 + !Efs/debugfs/file.c 98 + </sect1> 99 + </chapter> 100 + 101 + </book>
-60
Documentation/DocBook/kernel-api.tmpl
··· 182 </sect1> 183 </chapter> 184 185 - <chapter id="vfs"> 186 - <title>The Linux VFS</title> 187 - <sect1><title>The Filesystem types</title> 188 - !Iinclude/linux/fs.h 189 - </sect1> 190 - <sect1><title>The Directory Cache</title> 191 - !Efs/dcache.c 192 - !Iinclude/linux/dcache.h 193 - </sect1> 194 - <sect1><title>Inode Handling</title> 195 - !Efs/inode.c 196 - !Efs/bad_inode.c 197 - </sect1> 198 - <sect1><title>Registration and Superblocks</title> 199 - !Efs/super.c 200 - </sect1> 201 - <sect1><title>File Locks</title> 202 - !Efs/locks.c 203 - !Ifs/locks.c 204 - </sect1> 205 - <sect1><title>Other Functions</title> 206 - !Efs/mpage.c 207 - !Efs/namei.c 208 - !Efs/buffer.c 209 - !Efs/bio.c 210 - !Efs/seq_file.c 211 - !Efs/filesystems.c 212 - !Efs/fs-writeback.c 213 - !Efs/block_dev.c 214 - </sect1> 215 - </chapter> 216 - 217 - <chapter id="proc"> 218 - <title>The proc filesystem</title> 219 - 220 - <sect1><title>sysctl interface</title> 221 - !Ekernel/sysctl.c 222 - </sect1> 223 - 224 - <sect1><title>proc filesystem interface</title> 225 - !Ifs/proc/base.c 226 - </sect1> 227 - </chapter> 228 - 229 - <chapter id="sysfs"> 230 - <title>The Filesystem for Exporting Kernel Objects</title> 231 - !Efs/sysfs/file.c 232 - !Efs/sysfs/symlink.c 233 - !Efs/sysfs/bin.c 234 - </chapter> 235 - 236 - <chapter id="debugfs"> 237 - <title>The debugfs filesystem</title> 238 - 239 - <sect1><title>debugfs interface</title> 240 - !Efs/debugfs/inode.c 241 - !Efs/debugfs/file.c 242 - </sect1> 243 - </chapter> 244 - 245 <chapter id="relayfs"> 246 <title>relay interface support</title> 247
··· 182 </sect1> 183 </chapter> 184 185 <chapter id="relayfs"> 186 <title>relay interface support</title> 187