* Re: [PATCH] public-inbox-v2-format(5): fix formatting
2019-10-07 20:52 7% ` Eric Wong
@ 2019-10-07 21:13 7% ` Alyssa Ross
0 siblings, 0 replies; 3+ results
From: Alyssa Ross @ 2019-10-07 21:13 UTC (permalink / raw)
To: Eric Wong; +Cc: meta
[-- Attachment #1: Type: text/plain, Size: 480 bytes --]
> I noticed both the original and post-patch manpage exceeds the
> limits of an 80-column terminal. I think it's worth it to
> reflow and perhaps reword to ensure folks who are limited to 80
> columns can viwe (but I can take care of it, too, if you're busy)
>
> Even fitting 80 columns on my screen is a challenge with the
> giant fonts I need to workaround poor eyesight :<
I appreciate your commitment! I think you'd be a better judge of how
to format it nicely than me. :)
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]
^ permalink raw reply [relevance 7%]
* Re: [PATCH] public-inbox-v2-format(5): fix formatting
2019-10-07 20:27 6% [PATCH] public-inbox-v2-format(5): fix formatting Alyssa Ross
@ 2019-10-07 20:52 7% ` Eric Wong
2019-10-07 21:13 7% ` Alyssa Ross
0 siblings, 1 reply; 3+ results
From: Eric Wong @ 2019-10-07 20:52 UTC (permalink / raw)
To: Alyssa Ross; +Cc: meta
Alyssa Ross <hi@alyssa.is> wrote:
> This was being rendered as a paragraph, so line breaks weren't
> preserved and it was unreadable in man.
Thanks for noticing that, it's obvious I never really looked at
the result :x (and I'm writing a new .pod right now, too)
> diff --git a/Documentation/public-inbox-v2-format.pod b/Documentation/public-inbox-v2-format.pod
> index 28d3550..58e6b6d 100644
> --- a/Documentation/public-inbox-v2-format.pod
> +++ b/Documentation/public-inbox-v2-format.pod
> @@ -24,13 +24,13 @@ $EPOCH - Integer starting with 0 based on time
> $SCHEMA_VERSION - PublicInbox::Search::SCHEMA_VERSION used by Xapian
> $PART - Integer (0..NPROCESSORS)
Looks like the lines preceding this patch need to be indented to
preserve newlines, too.
> -foo/ # assuming "foo" is the name of the list
> -- inbox.lock # lock file (flock) to protect global state
> -- git/$EPOCH.git # normal git repositories
> -- all.git # empty git repo, alternates to git/$EPOCH.git
> -- xap$SCHEMA_VERSION/$SHARD # per-shard Xapian DB
> -- xap$SCHEMA_VERSION/over.sqlite3 # OVER-view DB for NNTP and threading
> -- msgmap.sqlite3 # same the v1 msgmap
> + foo/ # assuming "foo" is the name of the list
> + - inbox.lock # lock file (flock) to protect global state
> + - git/$EPOCH.git # normal git repositories
> + - all.git # empty git repo, alternates to git/$EPOCH.git
> + - xap$SCHEMA_VERSION/$SHARD # per-shard Xapian DB
> + - xap$SCHEMA_VERSION/over.sqlite3 # OVER-view DB for NNTP and threading
> + - msgmap.sqlite3 # same the v1 msgmap
I noticed both the original and post-patch manpage exceeds the
limits of an 80-column terminal. I think it's worth it to
reflow and perhaps reword to ensure folks who are limited to 80
columns can viwe (but I can take care of it, too, if you're busy)
Even fitting 80 columns on my screen is a challenge with the
giant fonts I need to workaround poor eyesight :<
^ permalink raw reply [relevance 7%]
* [PATCH] public-inbox-v2-format(5): fix formatting
@ 2019-10-07 20:27 6% Alyssa Ross
2019-10-07 20:52 7% ` Eric Wong
0 siblings, 1 reply; 3+ results
From: Alyssa Ross @ 2019-10-07 20:27 UTC (permalink / raw)
To: meta; +Cc: Alyssa Ross
This was being rendered as a paragraph, so line breaks weren't
preserved and it was unreadable in man.
---
Documentation/public-inbox-v2-format.pod | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/Documentation/public-inbox-v2-format.pod b/Documentation/public-inbox-v2-format.pod
index 28d3550..58e6b6d 100644
--- a/Documentation/public-inbox-v2-format.pod
+++ b/Documentation/public-inbox-v2-format.pod
@@ -24,13 +24,13 @@ $EPOCH - Integer starting with 0 based on time
$SCHEMA_VERSION - PublicInbox::Search::SCHEMA_VERSION used by Xapian
$PART - Integer (0..NPROCESSORS)
-foo/ # assuming "foo" is the name of the list
-- inbox.lock # lock file (flock) to protect global state
-- git/$EPOCH.git # normal git repositories
-- all.git # empty git repo, alternates to git/$EPOCH.git
-- xap$SCHEMA_VERSION/$SHARD # per-shard Xapian DB
-- xap$SCHEMA_VERSION/over.sqlite3 # OVER-view DB for NNTP and threading
-- msgmap.sqlite3 # same the v1 msgmap
+ foo/ # assuming "foo" is the name of the list
+ - inbox.lock # lock file (flock) to protect global state
+ - git/$EPOCH.git # normal git repositories
+ - all.git # empty git repo, alternates to git/$EPOCH.git
+ - xap$SCHEMA_VERSION/$SHARD # per-shard Xapian DB
+ - xap$SCHEMA_VERSION/over.sqlite3 # OVER-view DB for NNTP and threading
+ - msgmap.sqlite3 # same the v1 msgmap
For blob lookups, the reader only needs to open the "all.git"
repository with $GIT_DIR/objects/info/alternates which references
--
2.23.0
^ permalink raw reply related [relevance 6%]
Results 1-3 of 3 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2019-10-07 20:27 6% [PATCH] public-inbox-v2-format(5): fix formatting Alyssa Ross
2019-10-07 20:52 7% ` Eric Wong
2019-10-07 21:13 7% ` Alyssa Ross
Code repositories for project(s) associated with this public inbox
https://80x24.org/public-inbox.git
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 read-only IMAP folder(s) and NNTP newsgroup(s).