Skip to contentSkip to conversation

Move queue.3 to queue.7

PATCH In review Alejandro Colomar 2 participants 5 messages Oct 25, 2020 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

cover Move queue.3 to queue.7

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
Signature · 1 line
2.28.0
#1 lore raw

PATCH 1/3 queue.3, queue.7: Move queue.3 to queue.7

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.

---
 man3/queue.3 => man7/queue.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename man3/queue.3 => man7/queue.7 (98%)
man7/queue.7 renamed from man3/queue.3 +1 -1
similarity index 98%
rename from man3/queue.3
rename to man7/queue.7
index cbe72e29d..1fe48bd57 100644
@@ -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
Signature · 1 line
2.28.0
#2 lore raw

PATCH 2/3 queue.3: Link to queue(7)

In reply to Alejandro Colomar

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.

---
 man3/queue.3 | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 man3/queue.3
man3/queue.3 new file +1 -0
new file mode 100644
index 000000000..000e4b150
@@ -0,0 +1 @@
+.so man7/queue.7
Signature · 1 line
2.28.0
#3 lore raw

PATCH 3/3 circleq.3, insque.3, list.3, slist.3, tailq.3: SEE ALSO: queue(3) -> queue(7)

In reply to Alejandro Colomar

queue.3 has been moved to queue.7.

Fix SEE ALSO accordingly.

---
 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(-)
man3/circleq.3 +1 -1
index dc74dc910..8e520e71d 100644
@@ -354,4 +354,4 @@ main(void)
 .EE
 .SH SEE ALSO
 .BR insque (3),
-.BR queue (3)
+.BR queue (7)
man3/insque.3 +1 -1
index 153032c86..eb0237117 100644
@@ -257,4 +257,4 @@ main(int argc, char *argv[])
 }
 .EE
 .SH SEE ALSO
-.BR queue (3)
+.BR queue (7)
man3/list.3 +1 -1
index e70b6729b..e911da0d4 100644
@@ -346,4 +346,4 @@ main(void)
 .EE
 .SH SEE ALSO
 .BR insque (3),
-.BR queue (3)
+.BR queue (7)
man3/slist.3 +1 -1
index 53e310f0a..af8629ea6 100644
@@ -354,4 +354,4 @@ main(void)
 .EE
 .SH SEE ALSO
 .BR insque (3),
-.BR queue (3)
+.BR queue (7)
man3/tailq.3 +1 -1
index a782a51e2..a58434ba6 100644
@@ -437,4 +437,4 @@ main(void)
 .EE
 .SH SEE ALSO
 .BR insque (3),
-.BR queue (3)
+.BR queue (7)
Signature · 1 line
2.28.0
#4 lore raw
In reply to Alejandro Colomar

Hi Alex,

Quoted 9 lines · Alejandro Colomar

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

Quoted 16 lines

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
Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/