kdave
Document ioctls
- make list of all supported ioctls
- annotate with versions
- list used structures
- enumerate constraints
- possibly make short examples
- refer to existing commands
The format should suit a manual page, the html output generated from asciidoc is usually ok.
Nice idea! Feel free to steal ideas for examples or documentation text from the documentation I put into commit messages in python-btrfs, while implementing them. For example https://github.com/knorrie/python-btrfs/commit/0905e30bc249498764c3d46de6fc462e1eeb6335
Thanks, that would be a great source of course. The contents is one thing, I got stuck on the formatting side so that the output does not look totally ugly in the manual page output, preview in https://github.com/kdave/btrfs-progs/tree/doc/btrfs-ioctl
Setting the milestone to 4.14 was too optimistic. I've added the btrfs-ioctl page skeleton with some examples, so we can add the text incrementally.
Documentation/btrfs-ioctl.rst, basic structure is laid out with some examples.
https://btrfs.readthedocs.io/en/latest/btrfs-ioctl.html ioctls are incrementally added, the basic structure is now more or less done so adding new ones should be easy. Any help welcome.