From: Eric Wong <e@80x24.org>
To: meta@public-inbox.org
Subject: [PATCH 2/4] doc: flow: update with newer tools, note forkability
Date: Wed, 15 Feb 2023 08:01:10 +0000 [thread overview]
Message-ID: <20230215080112.1740815-3-e@80x24.org> (raw)
In-Reply-To: <20230215080112.1740815-1-e@80x24.org>
public-inbox-{clone,fetch,netd} are all relatively new
developments which we can document, here.
We'll also update the generator Makefile snippet since there may
be more Graph::Easy-based docs coming.
---
Documentation/flow.ge | 13 +++++++++----
Documentation/flow.txt | 18 ++++++++++++------
Documentation/include.mk | 15 +++++++++------
3 files changed, 30 insertions(+), 16 deletions(-)
diff --git a/Documentation/flow.ge b/Documentation/flow.ge
index 4308989a..5ad92fec 100644
--- a/Documentation/flow.ge
+++ b/Documentation/flow.ge
@@ -1,9 +1,11 @@
# public-inbox data flow
#
# Note: choose either "delivery tools" OR "git mirroring tools"
-# for a given inboxdir. Combining them for the SAME inboxdir
-# will cause conflicts. Of course, different inboxdirs may
-# choose different means of getting mail into them.
+# for a given inboxdir. Using them simultaneously for the
+# SAME inboxdir will cause conflicts. Of course, different
+# inboxdirs may choose different means of getting mail into them.
+# You may fork any inbox by starting with "git mirroring tools",
+# and switching to "delivery tools".
graph { flow: down }
@@ -13,6 +15,8 @@ graph { flow: down }
public-inbox-learn] -> [inboxdir]
[git mirroring tools:\n
+ public-inbox-clone,\n
+ public-inbox-fetch,\n
grok-pull,\n
various scripts
] -- git (clone|fetch) &&\n
@@ -20,9 +24,10 @@ graph { flow: down }
[inboxdir] ->
[read-only daemons:\n
+ public-inbox-netd\n
public-inbox-httpd\n
public-inbox-imapd\n
public-inbox-nntpd]
-# Copyright 2020-2021 all contributors <meta@public-inbox.org>
+# Copyright all contributors <meta@public-inbox.org>
# License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
diff --git a/Documentation/flow.txt b/Documentation/flow.txt
index 1116a917..ed2dd80b 100644
--- a/Documentation/flow.txt
+++ b/Documentation/flow.txt
@@ -1,9 +1,11 @@
# public-inbox data flow
#
# Note: choose either "delivery tools" OR "git mirroring tools"
-# for a given inboxdir. Combining them for the SAME inboxdir
-# will cause conflicts. Of course, different inboxdirs may
-# choose different means of getting mail into them.
+# for a given inboxdir. Using them simultaneously for the
+# SAME inboxdir will cause conflicts. Of course, different
+# inboxdirs may choose different means of getting mail into them.
+# You may fork any inbox by starting with "git mirroring tools",
+# and switching to "delivery tools".
+--------------------+
| delivery tools: |
@@ -15,8 +17,10 @@
|
v
+----------------------+ +--------------------+
-| git mirroring tools: | git (clone|fetch) && | |
-| grok-pull, | public-inbox-index | inboxdir |
+| git mirroring tools: | | |
+| public-inbox-clone, | | |
+| public-inbox-fetch, | git (clone|fetch) && | inboxdir |
+| grok-pull, | public-inbox-index | |
| various scripts | ----------------------> | |
+----------------------+ +--------------------+
|
@@ -24,10 +28,12 @@
v
+--------------------+
| read-only daemons: |
+ | public-inbox-netd |
| public-inbox-httpd |
| public-inbox-imapd |
| public-inbox-nntpd |
+--------------------+
-# Copyright 2020-2021 all contributors <meta@public-inbox.org>
+# Copyright all contributors <meta@public-inbox.org>
# License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
+# This file was generated from flow.txt using Graph::Easy
diff --git a/Documentation/include.mk b/Documentation/include.mk
index bfbc495f..4395e4f4 100644
--- a/Documentation/include.mk
+++ b/Documentation/include.mk
@@ -1,4 +1,4 @@
-# Copyright (C) 2013-2021 all contributors <meta@public-inbox.org>
+# Copyright (C) all contributors <meta@public-inbox.org>
# License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
all::
@@ -67,13 +67,16 @@ Documentation/standards.txt : Documentation/standards.perl
# flow.txt is checked into git since Graph::Easy isn't in many distros
Documentation/flow.txt : Documentation/flow.ge
- (sed -ne '1,/^$$/p' <Documentation/flow.ge; \
- $(GRAPH_EASY) Documentation/flow.ge || \
- cat Documentation/flow.txt; \
+
+%.txt : %.ge
+ (sed -ne '1,/^$$/p' <$<; \
+ $(GRAPH_EASY) $< || grep -v '^#' $@; \
echo; \
- sed -ne '/^# Copyright/,$$p' <Documentation/flow.ge \
+ sed -ne '/^# Copyright/,$$p' <$< \
) >$@+
- touch -r Documentation/flow.ge $@+
+ echo >>$@+ \
+ '# This file was generated from $(@F) using Graph::Easy'
+ touch -r $< $@+
mv $@+ $@
Documentation/lei-q.pod : lib/PublicInbox/Search.pm Documentation/common.perl
next prev parent reply other threads:[~2023-02-15 8:01 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-02-15 8:01 [PATCH 0/4] various doc updates Eric Wong
2023-02-15 8:01 ` [PATCH 1/4] doc: WWW + cgi: favor -netd over -httpd Eric Wong
2023-02-15 8:01 ` Eric Wong [this message]
2023-02-15 8:01 ` [PATCH 3/4] doc: extindex update on configuration and union section Eric Wong
2023-02-15 8:01 ` [PATCH 4/4] Makefile.PL: drop update-copyrights rule Eric Wong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://public-inbox.org/README
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20230215080112.1740815-3-e@80x24.org \
--to=e@80x24.org \
--cc=meta@public-inbox.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).