RepoMirrors
/
btrfs-progs
mirror of https://github.com/kdave/btrfs-progs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
btrfs-progs/Documentation/index.rst

50 lines
697 B
ReStructuredText
Raw Normal View History

btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
.. BTRFS documentation master file
btrfs-progs: docs: add sphinx build support Add basic config and build files for sphinx. The long term plan is to convert all asciidoc sources to ReST and host majority of wiki contents, and maybe more. Build: $ cd Documentation/ $ make -f Makefile.sphinx html The result is in Documentation/_build/html. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 20:48:27 +00:00
Welcome to BTRFS documentation!
===============================
.. toctree::
btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
:maxdepth: 1
btrfs-progs: docs: add more of the new doc structure Add overall structure for now, some contents is from wiki. Signed-off-by: David Sterba <dsterba@suse.com>
2021-11-30 15:00:48 +00:00
:caption: Overview
btrfs-progs: docs: add sphinx build support Add basic config and build files for sphinx. The long term plan is to convert all asciidoc sources to ReST and host majority of wiki contents, and maybe more. Build: $ cd Documentation/ $ make -f Makefile.sphinx html The result is in Documentation/_build/html. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 20:48:27 +00:00
btrfs-progs: docs: add more of the new doc structure Add overall structure for now, some contents is from wiki. Signed-off-by: David Sterba <dsterba@suse.com>
2021-11-30 15:00:48 +00:00
Introduction
btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
man-index
btrfs-progs: docs: add sphinx build support Add basic config and build files for sphinx. The long term plan is to convert all asciidoc sources to ReST and host majority of wiki contents, and maybe more. Build: $ cd Documentation/ $ make -f Makefile.sphinx html The result is in Documentation/_build/html. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 20:48:27 +00:00
btrfs-progs: docs: add more of the new doc structure Add overall structure for now, some contents is from wiki. Signed-off-by: David Sterba <dsterba@suse.com>
2021-11-30 15:00:48 +00:00
.. toctree::
:maxdepth: 1
:caption: Features:
Common-features
Custom-ioctls
Auto-repair
Balance
Compression
Checksumming
Convert
Deduplication
Defragmentation
Inline-files
Qgroups
Reflink
Resize
Scrub
Seeding-device
Send-receive
Subvolumes
btrfs-progs: docs: split swapfile from section 5 Signed-off-by: David Sterba <dsterba@suse.com>
2022-01-11 22:56:25 +00:00
Swapfile
btrfs-progs: docs: add more of the new doc structure Add overall structure for now, some contents is from wiki. Signed-off-by: David Sterba <dsterba@suse.com>
2021-11-30 15:00:48 +00:00
Tree-checker
Trim
Volume-management
Zoned-mode
.. toctree::
:maxdepth: 1
:caption: TODO
btrfs-progs: docs: add more chapters (part 3) All main pages have some content and many typos have been fixed. Signed-off-by: David Sterba <dsterba@suse.com>
2021-12-17 09:49:39 +00:00
Quick-start
btrfs-progs: docs: add more of the new doc structure Add overall structure for now, some contents is from wiki. Signed-off-by: David Sterba <dsterba@suse.com>
2021-11-30 15:00:48 +00:00
Interoperability
Glossary
Flexibility
project-index
trouble-index