* [PATCH 0/3] Move queue.3 to queue.7
@ 2020-10-25 20:46 Alejandro Colomar
2020-10-25 20:46 ` [PATCH 1/3] queue.3, queue.7: " Alejandro Colomar
` (3 more replies)
0 siblings, 4 replies; 5+ messages in thread
From: Alejandro Colomar @ 2020-10-25 20:46 UTC (permalink / raw)
To: mtk.manpages; +Cc: Alejandro Colomar, linux-man
Hi Michael,
I think this page belongs in Section 7 now.
I agree that it needs a link for legacy reasons;
otherwise, many hyperlinks to the online queue(3) would break.
I'm sending you the commits as I wrote them,
I don't know if you prefer them separately or squashed.
Feel free to squash them together if you prefer.
Cheers,
Alex
Alejandro Colomar (3):
queue.3, queue.7: Move queue.3 to queue.7
queue.3: Link to queue(7)
circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) ->
queue(7)
man3/circleq.3 | 2 +-
man3/insque.3 | 2 +-
man3/list.3 | 2 +-
man3/queue.3 | 149 +------------------------------------------------
man3/slist.3 | 2 +-
man3/tailq.3 | 2 +-
man7/queue.7 | 148 ++++++++++++++++++++++++++++++++++++++++++++++++
7 files changed, 154 insertions(+), 153 deletions(-)
create mode 100644 man7/queue.7
--
2.28.0
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 1/3] queue.3, queue.7: Move queue.3 to queue.7
2020-10-25 20:46 [PATCH 0/3] Move queue.3 to queue.7 Alejandro Colomar
@ 2020-10-25 20:46 ` Alejandro Colomar
2020-10-25 20:46 ` [PATCH 2/3] queue.3: Link to queue(7) Alejandro Colomar
` (2 subsequent siblings)
3 siblings, 0 replies; 5+ messages in thread
From: Alejandro Colomar @ 2020-10-25 20:46 UTC (permalink / raw)
To: mtk.manpages; +Cc: Alejandro Colomar, linux-man
After forking slist.3, list.3, tailq.3, stailq.3 & circleq.3
in the previous commits,
this page no longer belongs in Section 3 of the manual pages.
According to its contents, the most suitable section is Section 7.
Because of legacy reasons, a link queue.3 -> queue(7)
would be appropriate.
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man3/queue.3 => man7/queue.7 | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
rename man3/queue.3 => man7/queue.7 (98%)
diff --git a/man3/queue.3 b/man7/queue.7
similarity index 98%
rename from man3/queue.3
rename to man7/queue.7
index cbe72e29d..1fe48bd57 100644
--- a/man3/queue.3
+++ b/man7/queue.7
@@ -29,7 +29,7 @@
.\" %%%LICENSE_END
.\"
.\"
-.TH QUEUE 3 2015-02-7 "GNU" "Linux Programmer's Manual"
+.TH QUEUE 7 2015-02-7 "GNU" "Linux Programmer's Manual"
.SH NAME
queue \- implementations of linked lists and queues
.SH DESCRIPTION
--
2.28.0
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [PATCH 2/3] queue.3: Link to queue(7)
2020-10-25 20:46 [PATCH 0/3] Move queue.3 to queue.7 Alejandro Colomar
2020-10-25 20:46 ` [PATCH 1/3] queue.3, queue.7: " Alejandro Colomar
@ 2020-10-25 20:46 ` Alejandro Colomar
2020-10-25 20:46 ` [PATCH 3/3] circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) -> queue(7) Alejandro Colomar
2020-10-25 21:19 ` [PATCH 0/3] Move queue.3 to queue.7 Michael Kerrisk (man-pages)
3 siblings, 0 replies; 5+ messages in thread
From: Alejandro Colomar @ 2020-10-25 20:46 UTC (permalink / raw)
To: mtk.manpages; +Cc: Alejandro Colomar, linux-man
queue has been for so many years in Section 3,
and still is in Section 3 in most manuals.
For legacy reasons,
especially because hyperlinks to the online manual pages
would break otherwise,
a link queue.3 -> queue(7) is necessary.
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man3/queue.3 | 1 +
1 file changed, 1 insertion(+)
create mode 100644 man3/queue.3
diff --git a/man3/queue.3 b/man3/queue.3
new file mode 100644
index 000000000..000e4b150
--- /dev/null
+++ b/man3/queue.3
@@ -0,0 +1 @@
+.so man7/queue.7
--
2.28.0
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [PATCH 3/3] circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) -> queue(7)
2020-10-25 20:46 [PATCH 0/3] Move queue.3 to queue.7 Alejandro Colomar
2020-10-25 20:46 ` [PATCH 1/3] queue.3, queue.7: " Alejandro Colomar
2020-10-25 20:46 ` [PATCH 2/3] queue.3: Link to queue(7) Alejandro Colomar
@ 2020-10-25 20:46 ` Alejandro Colomar
2020-10-25 21:19 ` [PATCH 0/3] Move queue.3 to queue.7 Michael Kerrisk (man-pages)
3 siblings, 0 replies; 5+ messages in thread
From: Alejandro Colomar @ 2020-10-25 20:46 UTC (permalink / raw)
To: mtk.manpages; +Cc: Alejandro Colomar, linux-man
queue.3 has been moved to queue.7.
Fix SEE ALSO accordingly.
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
---
man3/circleq.3 | 2 +-
man3/insque.3 | 2 +-
man3/list.3 | 2 +-
man3/slist.3 | 2 +-
man3/tailq.3 | 2 +-
5 files changed, 5 insertions(+), 5 deletions(-)
diff --git a/man3/circleq.3 b/man3/circleq.3
index dc74dc910..8e520e71d 100644
--- a/man3/circleq.3
+++ b/man3/circleq.3
@@ -354,4 +354,4 @@ main(void)
.EE
.SH SEE ALSO
.BR insque (3),
-.BR queue (3)
+.BR queue (7)
diff --git a/man3/insque.3 b/man3/insque.3
index 153032c86..eb0237117 100644
--- a/man3/insque.3
+++ b/man3/insque.3
@@ -257,4 +257,4 @@ main(int argc, char *argv[])
}
.EE
.SH SEE ALSO
-.BR queue (3)
+.BR queue (7)
diff --git a/man3/list.3 b/man3/list.3
index e70b6729b..e911da0d4 100644
--- a/man3/list.3
+++ b/man3/list.3
@@ -346,4 +346,4 @@ main(void)
.EE
.SH SEE ALSO
.BR insque (3),
-.BR queue (3)
+.BR queue (7)
diff --git a/man3/slist.3 b/man3/slist.3
index 53e310f0a..af8629ea6 100644
--- a/man3/slist.3
+++ b/man3/slist.3
@@ -354,4 +354,4 @@ main(void)
.EE
.SH SEE ALSO
.BR insque (3),
-.BR queue (3)
+.BR queue (7)
diff --git a/man3/tailq.3 b/man3/tailq.3
index a782a51e2..a58434ba6 100644
--- a/man3/tailq.3
+++ b/man3/tailq.3
@@ -437,4 +437,4 @@ main(void)
.EE
.SH SEE ALSO
.BR insque (3),
-.BR queue (3)
+.BR queue (7)
--
2.28.0
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH 0/3] Move queue.3 to queue.7
2020-10-25 20:46 [PATCH 0/3] Move queue.3 to queue.7 Alejandro Colomar
` (2 preceding siblings ...)
2020-10-25 20:46 ` [PATCH 3/3] circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) -> queue(7) Alejandro Colomar
@ 2020-10-25 21:19 ` Michael Kerrisk (man-pages)
3 siblings, 0 replies; 5+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-10-25 21:19 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: mtk.manpages, linux-man
Hi Alex,
On 10/25/20 9:46 PM, Alejandro Colomar wrote:
> Hi Michael,
>
> I think this page belongs in Section 7 now.
> I agree that it needs a link for legacy reasons;
> otherwise, many hyperlinks to the online queue(3) would break.
>
> I'm sending you the commits as I wrote them,
> I don't know if you prefer them separately or squashed.
> Feel free to squash them together if you prefer.
Thanks. I've applied the series. I kept the patches separate.
Thanks,
Michael
> Alejandro Colomar (3):
> queue.3, queue.7: Move queue.3 to queue.7
> queue.3: Link to queue(7)
> circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) ->
> queue(7)
>
> man3/circleq.3 | 2 +-
> man3/insque.3 | 2 +-
> man3/list.3 | 2 +-
> man3/queue.3 | 149 +------------------------------------------------
> man3/slist.3 | 2 +-
> man3/tailq.3 | 2 +-
> man7/queue.7 | 148 ++++++++++++++++++++++++++++++++++++++++++++++++
> 7 files changed, 154 insertions(+), 153 deletions(-)
> create mode 100644 man7/queue.7
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2020-10-25 21:19 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-10-25 20:46 [PATCH 0/3] Move queue.3 to queue.7 Alejandro Colomar
2020-10-25 20:46 ` [PATCH 1/3] queue.3, queue.7: " Alejandro Colomar
2020-10-25 20:46 ` [PATCH 2/3] queue.3: Link to queue(7) Alejandro Colomar
2020-10-25 20:46 ` [PATCH 3/3] circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) -> queue(7) Alejandro Colomar
2020-10-25 21:19 ` [PATCH 0/3] Move queue.3 to queue.7 Michael Kerrisk (man-pages)
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).