[Bug 1882596] Re: systemd.unit(5) incorrectly refers to systemd.syntax(5)

[Dan Streetman]

** Also affects: systemd (Ubuntu Focal)
   Importance: Undecided
       Status: New

** Also affects: systemd (Ubuntu Groovy)
   Importance: Low
       Status: Confirmed

** Changed in: systemd (Ubuntu Focal)
   Importance: Undecided => Low

** Description changed:

+ [impact]
+ 
+ some systemd man pages refer to the wrong man section for some
+ references
+ 
+ [test case]
+ 
+ e.g.
+ 
+ $ man systemd.network | grep systemd.syntax
+        A plain ini-style text file that encodes network configuration for matching network interfaces, used by systemd-networkd(8). See systemd.syntax(5) for a general description of the syntax.
+ 
+ $ man 5 systemd.syntax
+ No manual entry for systemd.syntax in section 5
+ 
+ [regression potential]
+ 
+ any regression would possibly cause confusion by referencing the wrong
+ man section, or possibly cause a build failure, or problem with various
+ man pages for systemd
+ 
+ [scope]
+ 
+ this is needed for f/g
+ 
+ there is no systemd.syntax manpage in b or earlier
+ 
+ [original description]
+ 
  In Ubuntu 20.04 LTS there is no systemd.syntax(5) it is actually
  systemd.syntax(7).
  
  "See systemd.syntax(5) for a general description of the syntax."

** Changed in: systemd (Ubuntu Focal)
       Status: New => In Progress

** Changed in: systemd (Ubuntu Groovy)
       Status: Confirmed => In Progress

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to systemd in Ubuntu.
https://bugs.launchpad.net/bugs/1882596

Title:
  systemd.unit(5)  incorrectly refers to systemd.syntax(5)

Status in systemd package in Ubuntu:
  In Progress
Status in systemd source package in Focal:
  In Progress
Status in systemd source package in Groovy:
  In Progress

Bug description:
  [impact]

  some systemd man pages refer to the wrong man section for some
  references

  [test case]

  e.g.

  $ man systemd.network | grep systemd.syntax
         A plain ini-style text file that encodes network configuration for matching network interfaces, used by systemd-networkd(8). See systemd.syntax(5) for a general description of the syntax.

  $ man 5 systemd.syntax
  No manual entry for systemd.syntax in section 5

  [regression potential]

  any regression would possibly cause confusion by referencing the wrong
  man section, or possibly cause a build failure, or problem with
  various man pages for systemd

  [scope]

  this is needed for f/g

  there is no systemd.syntax manpage in b or earlier

  [original description]

  In Ubuntu 20.04 LTS there is no systemd.syntax(5) it is actually
  systemd.syntax(7).

  "See systemd.syntax(5) for a general description of the syntax."

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/systemd/+bug/1882596/+subscriptions