diff --git a/hgext/remotefilelog/__init__.py b/hgext/remotefilelog/__init__.py
--- a/hgext/remotefilelog/__init__.py
+++ b/hgext/remotefilelog/__init__.py
@@ -20,70 +20,106 @@
 Configs:
 
     ``packs.maxchainlen`` specifies the maximum delta chain length in pack files
+
     ``packs.maxpacksize`` specifies the maximum pack file size
+
     ``packs.maxpackfilecount`` specifies the maximum number of packs in the
       shared cache (trees only for now)
+
     ``remotefilelog.backgroundprefetch`` runs prefetch in background when True
+
     ``remotefilelog.bgprefetchrevs`` specifies revisions to fetch on commit and
       update, and on other commands that use them. Different from pullprefetch.
+
     ``remotefilelog.gcrepack`` does garbage collection during repack when True
+
     ``remotefilelog.nodettl`` specifies maximum TTL of a node in seconds before
       it is garbage collected
+
     ``remotefilelog.repackonhggc`` runs repack on hg gc when True
+
     ``remotefilelog.prefetchdays`` specifies the maximum age of a commit in
       days after which it is no longer prefetched.
+
     ``remotefilelog.prefetchdelay`` specifies delay between background
       prefetches in seconds after operations that change the working copy parent
+
     ``remotefilelog.data.gencountlimit`` constraints the minimum number of data
       pack files required to be considered part of a generation. In particular,
       minimum number of packs files > gencountlimit.
+
     ``remotefilelog.data.generations`` list for specifying the lower bound of
       each generation of the data pack files. For example, list ['100MB','1MB']
       or ['1MB', '100MB'] will lead to three generations: [0, 1MB), [
       1MB, 100MB) and [100MB, infinity).
+
     ``remotefilelog.data.maxrepackpacks`` the maximum number of pack files to
       include in an incremental data repack.
+
     ``remotefilelog.data.repackmaxpacksize`` the maximum size of a pack file for
       it to be considered for an incremental data repack.
+
     ``remotefilelog.data.repacksizelimit`` the maximum total size of pack files
       to include in an incremental data repack.
+
     ``remotefilelog.history.gencountlimit`` constraints the minimum number of
       history pack files required to be considered part of a generation. In
       particular, minimum number of packs files > gencountlimit.
+
     ``remotefilelog.history.generations`` list for specifying the lower bound of
       each generation of the historhy pack files. For example, list [
       '100MB', '1MB'] or ['1MB', '100MB'] will lead to three generations: [
       0, 1MB), [1MB, 100MB) and [100MB, infinity).
+
     ``remotefilelog.history.maxrepackpacks`` the maximum number of pack files to
       include in an incremental history repack.
+
     ``remotefilelog.history.repackmaxpacksize`` the maximum size of a pack file
       for it to be considered for an incremental history repack.
+
     ``remotefilelog.history.repacksizelimit`` the maximum total size of pack
       files to include in an incremental history repack.
+
     ``remotefilelog.backgroundrepack`` automatically consolidate packs in the
       background
+
     ``remotefilelog.cachepath`` path to cache
+
     ``remotefilelog.cachegroup`` if set, make cache directory sgid to this
       group
+
     ``remotefilelog.cacheprocess`` binary to invoke for fetching file data
+
     ``remotefilelog.debug`` turn on remotefilelog-specific debug output
+
     ``remotefilelog.excludepattern`` pattern of files to exclude from pulls
-    ``remotefilelog.includepattern``pattern of files to include in pulls
+
+    ``remotefilelog.includepattern`` pattern of files to include in pulls
+
     ``remotefilelog.fetchwarning``: message to print when too many
       single-file fetches occur
+
     ``remotefilelog.getfilesstep`` number of files to request in a single RPC
+
     ``remotefilelog.getfilestype`` if set to 'threaded' use threads to fetch
       files, otherwise use optimistic fetching
+
     ``remotefilelog.pullprefetch`` revset for selecting files that should be
       eagerly downloaded rather than lazily
+
     ``remotefilelog.reponame`` name of the repo. If set, used to partition
       data from other repos in a shared store.
+
     ``remotefilelog.server`` if true, enable server-side functionality
+
     ``remotefilelog.servercachepath`` path for caching blobs on the server
+
     ``remotefilelog.serverexpiration`` number of days to keep cached server
       blobs
+
     ``remotefilelog.validatecache`` if set, check cache entries for corruption
       before returning blobs
+
     ``remotefilelog.validatecachelog`` if set, check cache entries for
       corruption before returning metadata