[PATCH 0/3] Move queue.3 to queue.7

[PATCH 0/3] Move queue.3 to queue.7

[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.

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

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

[Alejandro Colomar]

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

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

[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.

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

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

[Alejandro Colomar]

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

Re: [PATCH 0/3] Move queue.3 to queue.7

[Michael Kerrisk (man-pages)]

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/