* [f2fs-dev] [PATCH 00/29] Documentation fixes
@ 2020-06-15 6:46 Mauro Carvalho Chehab
2020-06-15 6:46 ` [f2fs-dev] [PATCH 11/29] fs: docs: f2fs.rst: fix a broken table Mauro Carvalho Chehab
0 siblings, 1 reply; 2+ messages in thread
From: Mauro Carvalho Chehab @ 2020-06-15 6:46 UTC (permalink / raw)
To: Linux Doc Mailing List
Cc: Heiko Stübner, Geert Uytterhoeven, Catalin Marinas,
Linus Walleij, dri-devel, Paul Mackerras, Christoph Hellwig,
Marek Szyprowski, linux-arch, Mike Snitzer, Bartosz Golaszewski,
Michael Ellerman, kasan-dev, Ingo Molnar, Alan Stern,
NXP Linux Team, Benjamin Herrenschmidt, Boqun Feng,
Nicholas Piggin, Alexander Viro, Thomas Gleixner,
Greg Kroah-Hartman, linux-kernel, linux-spi,
Pengutronix Kernel Team, linux-fsdevel, Andrew Morton,
alsa-devel, linux-ia64, David Airlie, James E.J. Bottomley,
Eric Dumazet, keyrings, Shuah Khan, Alasdair Kergon, Daniel Kiss,
Stephen Rothwell, Fabio Estevam, Helge Deller, linux-rockchip,
linux-media, Andrea Parri, linux-arm-msm, Sean Wang, linux-gpio,
Bjorn Helgaas, Jaegeuk Kim, linux-arm-kernel,
Niklas Söderlund, Tony Luck, dm-devel, Alexey Gladkov,
Arnaud Pouliquen, Sandy Huang, linux-f2fs-devel,
linux-renesas-soc, Eric W. Biederman, Mike Kravetz, linux-pci,
Akira Yokosawa, Lai Jiangshan, Jarkko Sakkinen, Dave Hansen,
linux-kselftest, Joel Fernandes, Sukadev Bhattiprolu,
Will Deacon, Florian Fainelli, Jonathan Corbet, Haren Myneni,
Gerald Schaefer, Federico Vaga, Jade Alglave, Alexey Dobriyan,
Fenghua Yu, Marco Elver, Kees Cook, Josh Triplett,
Steven Rostedt, rcu, Mark Brown, Mathieu Desnoyers, Luc Maranget,
Thomas Bogendoerfer, linux-parisc, Jeff Layton, Liam Girdwood,
iommu, netdev, Shawn Guo, David S. Miller, Thiago Jung Bauermann,
Jan Kara, Peter Zijlstra (Intel),
Bjorn Andersson, David Howells, linux-mm, Sandipan Das,
H. Peter Anvin, Mauro Carvalho Chehab, x86, Russell King,
Andy Gross, Jakub Kicinski, Sascha Hauer, devicetree,
Philipp Zabel, Paul E. McKenney, Daniel Lustig, Lubomir Rintel,
Rob Herring, linux-mediatek, Matthias Brugger, Dmitry Vyukov,
Robin Murphy, Akira Shimahara, linux-mips, linux-bluetooth,
Daniel Vetter, Borislav Petkov, linuxppc-dev
Hi Jon,
That's a bunch of files I have to be applied on the top of v5.8-rc1 fixing
documentation warnings. I already removed some duplicated stuff.
Regards,
Mauro
Mauro Carvalho Chehab (29):
mm: vmalloc.c: remove a kernel-doc annotation from a removed parameter
net: dev: add a missing kernel-doc annotation
net: netdevice.h: add a description for napi_defer_hard_irqs
scripts/kernel-doc: parse __ETHTOOL_DECLARE_LINK_MODE_MASK
net: pylink.h: add kernel-doc descriptions for new fields at
phylink_config
scripts/kernel-doc: handle function pointer prototypes
fs: fs.h: fix a kernel-doc parameter description
gpio: driver.h: fix kernel-doc markup
kcsan: fix a kernel-doc warning
rcu: fix some kernel-doc warnings
fs: docs: f2fs.rst: fix a broken table
dt: update a reference for reneases pcar file renamed to yaml
dt: fix broken links due to txt->yaml renames
dt: Fix broken references to renamed docs
dt: fix reference to olpc,xo1.75-ec.txt
selftests/vm/keys: fix a broken reference at protection_keys.c
docs: hugetlbpage.rst: fix some warnings
docs: powerpc: fix some issues at vas-api.rst
docs: driver-model: remove a duplicated markup at driver.rst
docs: watch_queue.rst: supress some Sphinx warnings and move to
core-api
docs: device-mapper: add dm-ebs.rst to an index file
docs: it_IT: add two missing references
docs: ABI: fix a typo when pointing to w1-generic.rst
docs: fs: locking.rst: fix a broken table
docs: add bus-virt-phys-mapping.txt to core-api
docs: fix references for DMA*.txt files
docs: dt: minor adjustments at writing-schema.rst
docs: fs: proc.rst: fix a warning due to a merge conflict
docs: fs: proc.rst: convert a new chapter to ReST
.../ABI/testing/sysfs-driver-w1_therm | 2 +-
Documentation/PCI/pci.rst | 6 +-
.../admin-guide/device-mapper/index.rst | 1 +
Documentation/admin-guide/mm/hugetlbpage.rst | 25 ++-
Documentation/block/biodoc.rst | 2 +-
.../bus-virt-phys-mapping.rst} | 2 +-
Documentation/core-api/dma-api.rst | 6 +-
Documentation/core-api/dma-isa-lpc.rst | 2 +-
Documentation/core-api/index.rst | 2 +
Documentation/{ => core-api}/watch_queue.rst | 34 ++--
.../bindings/arm/freescale/fsl,scu.txt | 2 +-
.../bindings/display/bridge/sii902x.txt | 2 +-
.../bindings/display/imx/fsl-imx-drm.txt | 4 +-
.../devicetree/bindings/display/imx/ldb.txt | 4 +-
.../display/rockchip/rockchip-drm.yaml | 2 +-
.../bindings/misc/olpc,xo1.75-ec.txt | 2 +-
.../bindings/net/mediatek-bluetooth.txt | 2 +-
.../bindings/pinctrl/renesas,pfc-pinctrl.txt | 2 +-
.../bindings/sound/audio-graph-card.txt | 2 +-
.../bindings/sound/st,sti-asoc-card.txt | 2 +-
.../bindings/spi/qcom,spi-geni-qcom.txt | 2 +-
Documentation/devicetree/writing-schema.rst | 9 +-
.../driver-api/driver-model/driver.rst | 2 -
Documentation/driver-api/usb/dma.rst | 6 +-
Documentation/filesystems/f2fs.rst | 150 ++++++++++++------
Documentation/filesystems/locking.rst | 6 +-
Documentation/filesystems/proc.rst | 46 +++---
Documentation/memory-barriers.txt | 6 +-
Documentation/mips/ingenic-tcu.rst | 2 +-
Documentation/powerpc/vas-api.rst | 23 ++-
Documentation/security/keys/core.rst | 2 +-
.../it_IT/process/management-style.rst | 2 +
.../it_IT/process/submitting-patches.rst | 2 +
.../translations/ko_KR/memory-barriers.txt | 6 +-
MAINTAINERS | 8 +-
arch/ia64/hp/common/sba_iommu.c | 12 +-
arch/parisc/kernel/pci-dma.c | 2 +-
arch/x86/include/asm/dma-mapping.h | 4 +-
arch/x86/kernel/amd_gart_64.c | 2 +-
drivers/parisc/sba_iommu.c | 14 +-
include/linux/dma-mapping.h | 2 +-
include/linux/fs.h | 2 +-
include/linux/gpio/driver.h | 2 +-
include/linux/kcsan-checks.h | 10 +-
include/linux/netdevice.h | 2 +
include/linux/phylink.h | 4 +
include/linux/rculist.h | 2 +-
include/linux/watch_queue.h | 2 +-
include/media/videobuf-dma-sg.h | 2 +-
init/Kconfig | 2 +-
kernel/dma/debug.c | 2 +-
kernel/watch_queue.c | 2 +-
mm/vmalloc.c | 1 -
net/core/dev.c | 1 +
scripts/kernel-doc | 7 +
tools/testing/selftests/vm/protection_keys.c | 2 +-
56 files changed, 282 insertions(+), 175 deletions(-)
rename Documentation/{bus-virt-phys-mapping.txt => core-api/bus-virt-phys-mapping.rst} (99%)
rename Documentation/{ => core-api}/watch_queue.rst (94%)
--
2.26.2
_______________________________________________
Linux-f2fs-devel mailing list
Linux-f2fs-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel
^ permalink raw reply [flat|nested] 2+ messages in thread
* [f2fs-dev] [PATCH 11/29] fs: docs: f2fs.rst: fix a broken table
2020-06-15 6:46 [f2fs-dev] [PATCH 00/29] Documentation fixes Mauro Carvalho Chehab
@ 2020-06-15 6:46 ` Mauro Carvalho Chehab
0 siblings, 0 replies; 2+ messages in thread
From: Mauro Carvalho Chehab @ 2020-06-15 6:46 UTC (permalink / raw)
To: Linux Doc Mailing List
Cc: Jonathan Corbet, Mauro Carvalho Chehab, linux-kernel,
linux-f2fs-devel, Jaegeuk Kim
As reported by Sphinx:
Documentation/filesystems/f2fs.rst:229: WARNING: Malformed table.
Text in column margin in table line 126.
====================== ============================================================
background_gc=%s Turn on/off cleaning operations, namely garbage
...
test_dummy_encryption
test_dummy_encryption=%s
Enable dummy encryption, which provides a fake fscrypt
context. The fake fscrypt context is used by xfstests.
The argument may be either "v1" or "v2", in order to
select the corresponding fscrypt policy version.
This table is now broken, as some texts are bigger than a
column. While it would be feasible to fix it by adding two extra
positions at the table, it would still output something wrong,
as "test_dummy_encryption" would appear on a separate row.
So, the best solution here seems to remove the table markup.
The html and PDF output won't be as nice as a table, but it will
still be reasonable.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
---
Documentation/filesystems/f2fs.rst | 150 +++++++++++++++++++----------
1 file changed, 98 insertions(+), 52 deletions(-)
diff --git a/Documentation/filesystems/f2fs.rst b/Documentation/filesystems/f2fs.rst
index 099d45ac8d8f..0c166716e4ba 100644
--- a/Documentation/filesystems/f2fs.rst
+++ b/Documentation/filesystems/f2fs.rst
@@ -101,8 +101,8 @@ Mount Options
=============
-====================== ============================================================
-background_gc=%s Turn on/off cleaning operations, namely garbage
+background_gc=%s
+ Turn on/off cleaning operations, namely garbage
collection, triggered in background when I/O subsystem is
idle. If background_gc=on, it will turn on the garbage
collection and if background_gc=off, garbage collection
@@ -110,65 +110,91 @@ background_gc=%s Turn on/off cleaning operations, namely garbage
on synchronous garbage collection running in background.
Default value for this option is on. So garbage
collection is on by default.
-disable_roll_forward Disable the roll-forward recovery routine
-norecovery Disable the roll-forward recovery routine, mounted read-
+disable_roll_forward
+ Disable the roll-forward recovery routine
+norecovery
+ Disable the roll-forward recovery routine, mounted read-
only (i.e., -o ro,disable_roll_forward)
-discard/nodiscard Enable/disable real-time discard in f2fs, if discard is
+discard/nodiscard
+ Enable/disable real-time discard in f2fs, if discard is
enabled, f2fs will issue discard/TRIM commands when a
segment is cleaned.
-no_heap Disable heap-style segment allocation which finds free
+no_heap
+ Disable heap-style segment allocation which finds free
segments for data from the beginning of main area, while
for node from the end of main area.
-nouser_xattr Disable Extended User Attributes. Note: xattr is enabled
+nouser_xattr
+ Disable Extended User Attributes. Note: xattr is enabled
by default if CONFIG_F2FS_FS_XATTR is selected.
-noacl Disable POSIX Access Control List. Note: acl is enabled
+noacl
+ Disable POSIX Access Control List. Note: acl is enabled
by default if CONFIG_F2FS_FS_POSIX_ACL is selected.
-active_logs=%u Support configuring the number of active logs. In the
+active_logs=%u
+ Support configuring the number of active logs. In the
current design, f2fs supports only 2, 4, and 6 logs.
Default number is 6.
-disable_ext_identify Disable the extension list configured by mkfs, so f2fs
+disable_ext_identify
+ Disable the extension list configured by mkfs, so f2fs
does not aware of cold files such as media files.
-inline_xattr Enable the inline xattrs feature.
-noinline_xattr Disable the inline xattrs feature.
-inline_xattr_size=%u Support configuring inline xattr size, it depends on
+inline_xattr
+ Enable the inline xattrs feature.
+noinline_xattr
+ Disable the inline xattrs feature.
+inline_xattr_size=%u
+ Support configuring inline xattr size, it depends on
flexible inline xattr feature.
-inline_data Enable the inline data feature: New created small(<~3.4k)
+inline_data
+ Enable the inline data feature: New created small(<~3.4k)
files can be written into inode block.
-inline_dentry Enable the inline dir feature: data in new created
+inline_dentry
+ Enable the inline dir feature: data in new created
directory entries can be written into inode block. The
space of inode block which is used to store inline
dentries is limited to ~3.4k.
-noinline_dentry Disable the inline dentry feature.
-flush_merge Merge concurrent cache_flush commands as much as possible
+noinline_dentry
+ Disable the inline dentry feature.
+flush_merge
+ Merge concurrent cache_flush commands as much as possible
to eliminate redundant command issues. If the underlying
device handles the cache_flush command relatively slowly,
recommend to enable this option.
-nobarrier This option can be used if underlying storage guarantees
+nobarrier
+ This option can be used if underlying storage guarantees
its cached data should be written to the novolatile area.
If this option is set, no cache_flush commands are issued
but f2fs still guarantees the write ordering of all the
data writes.
-fastboot This option is used when a system wants to reduce mount
+fastboot
+ This option is used when a system wants to reduce mount
time as much as possible, even though normal performance
can be sacrificed.
-extent_cache Enable an extent cache based on rb-tree, it can cache
+extent_cache
+ Enable an extent cache based on rb-tree, it can cache
as many as extent which map between contiguous logical
address and physical address per inode, resulting in
increasing the cache hit ratio. Set by default.
-noextent_cache Disable an extent cache based on rb-tree explicitly, see
+noextent_cache
+ Disable an extent cache based on rb-tree explicitly, see
the above extent_cache mount option.
-noinline_data Disable the inline data feature, inline data feature is
+noinline_data
+ Disable the inline data feature, inline data feature is
enabled by default.
-data_flush Enable data flushing before checkpoint in order to
+data_flush
+ Enable data flushing before checkpoint in order to
persist data of regular and symlink.
-reserve_root=%d Support configuring reserved space which is used for
+reserve_root=%d
+ Support configuring reserved space which is used for
allocation from a privileged user with specified uid or
gid, unit: 4KB, the default limit is 0.2% of user blocks.
-resuid=%d The user ID which may use the reserved blocks.
-resgid=%d The group ID which may use the reserved blocks.
-fault_injection=%d Enable fault injection in all supported types with
+resuid=%d
+ The user ID which may use the reserved blocks.
+resgid=%d
+ The group ID which may use the reserved blocks.
+fault_injection=%d
+ Enable fault injection in all supported types with
specified injection rate.
-fault_type=%d Support configuring fault injection type, should be
+fault_type=%d
+ Support configuring fault injection type, should be
enabled with fault_injection option, fault type value
is shown below, it supports single or combined type.
@@ -191,32 +217,49 @@ fault_type=%d Support configuring fault injection type, should be
FAULT_DISCARD 0x000002000
FAULT_WRITE_IO 0x000004000
=================== ===========
-mode=%s Control block allocation mode which supports "adaptive"
+mode=%s
+ Control block allocation mode which supports "adaptive"
and "lfs". In "lfs" mode, there should be no random
writes towards main area.
-io_bits=%u Set the bit size of write IO requests. It should be set
+io_bits=%u
+ Set the bit size of write IO requests. It should be set
with "mode=lfs".
-usrquota Enable plain user disk quota accounting.
-grpquota Enable plain group disk quota accounting.
-prjquota Enable plain project quota accounting.
-usrjquota=<file> Appoint specified file and type during mount, so that quota
-grpjquota=<file> information can be properly updated during recovery flow,
-prjjquota=<file> <quota file>: must be in root directory;
-jqfmt=<quota type> <quota type>: [vfsold,vfsv0,vfsv1].
-offusrjquota Turn off user journelled quota.
-offgrpjquota Turn off group journelled quota.
-offprjjquota Turn off project journelled quota.
-quota Enable plain user disk quota accounting.
-noquota Disable all plain disk quota option.
-whint_mode=%s Control which write hints are passed down to block
+usrquota
+ Enable plain user disk quota accounting.
+grpquota
+ Enable plain group disk quota accounting.
+prjquota
+ Enable plain project quota accounting.
+usrjquota=<file>
+ Appoint specified file and type during mount, so that quota
+grpjquota=<file>
+ information can be properly updated during recovery flow,
+prjjquota=<file>
+ <quota file>: must be in root directory;
+jqfmt=<quota type>
+ <quota type>: [vfsold,vfsv0,vfsv1].
+offusrjquota
+ Turn off user journelled quota.
+offgrpjquota
+ Turn off group journelled quota.
+offprjjquota
+ Turn off project journelled quota.
+quota
+ Enable plain user disk quota accounting.
+noquota
+ Disable all plain disk quota option.
+whint_mode=%s
+ Control which write hints are passed down to block
layer. This supports "off", "user-based", and
"fs-based". In "off" mode (default), f2fs does not pass
down hints. In "user-based" mode, f2fs tries to pass
down hints given by users. And in "fs-based" mode, f2fs
passes down hints with its policy.
-alloc_mode=%s Adjust block allocation policy, which supports "reuse"
+alloc_mode=%s
+ Adjust block allocation policy, which supports "reuse"
and "default".
-fsync_mode=%s Control the policy of fsync. Currently supports "posix",
+fsync_mode=%s
+ Control the policy of fsync. Currently supports "posix",
"strict", and "nobarrier". In "posix" mode, which is
default, fsync will follow POSIX semantics and does a
light operation to improve the filesystem performance.
@@ -225,13 +268,14 @@ fsync_mode=%s Control the policy of fsync. Currently supports "posix",
pass, but the performance will regress. "nobarrier" is
based on "posix", but doesn't issue flush command for
non-atomic files likewise "nobarrier" mount option.
-test_dummy_encryption
-test_dummy_encryption=%s
+
+test_dummy_encryption, test_dummy_encryption=%s
Enable dummy encryption, which provides a fake fscrypt
context. The fake fscrypt context is used by xfstests.
The argument may be either "v1" or "v2", in order to
select the corresponding fscrypt policy version.
-checkpoint=%s[:%u[%]] Set to "disable" to turn off checkpointing. Set to "enable"
+checkpoint=%s[:%u[%]]
+ Set to "disable" to turn off checkpointing. Set to "enable"
to reenable checkpointing. Is enabled by default. While
disabled, any unmounting or unexpected shutdowns will cause
the filesystem contents to appear as they did when the
@@ -247,18 +291,20 @@ checkpoint=%s[:%u[%]] Set to "disable" to turn off checkpointing. Set to "enabl
hide up to all remaining free space. The actual space that
would be unusable can be viewed at /sys/fs/f2fs/<disk>/unusable
This space is reclaimed once checkpoint=enable.
-compress_algorithm=%s Control compress algorithm, currently f2fs supports "lzo",
+compress_algorithm=%s
+ Control compress algorithm, currently f2fs supports "lzo",
"lz4", "zstd" and "lzo-rle" algorithm.
-compress_log_size=%u Support configuring compress cluster size, the size will
+compress_log_size=%u
+ Support configuring compress cluster size, the size will
be 4KB * (1 << %u), 16KB is minimum size, also it's
default size.
-compress_extension=%s Support adding specified extension, so that f2fs can enable
+compress_extension=%s
+ Support adding specified extension, so that f2fs can enable
compression on those corresponding files, e.g. if all files
with '.ext' has high compression rate, we can set the '.ext'
on compression extension list and enable compression on
these file by default rather than to enable it via ioctl.
For other files, we can still enable compression via ioctl.
-====================== ============================================================
Debugfs Entries
===============
--
2.26.2
_______________________________________________
Linux-f2fs-devel mailing list
Linux-f2fs-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/linux-f2fs-devel
^ permalink raw reply related [flat|nested] 2+ messages in thread
end of thread, other threads:[~2020-06-15 6:47 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-06-15 6:46 [f2fs-dev] [PATCH 00/29] Documentation fixes Mauro Carvalho Chehab
2020-06-15 6:46 ` [f2fs-dev] [PATCH 11/29] fs: docs: f2fs.rst: fix a broken table Mauro Carvalho Chehab
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).