Update manpages

- dev-cmd/man: sort the `cmd_path`s (for APFS)
- update manpages based on latest content

Library/Homebrew/dev-cmd/man.rb

@@ -184,7 +184,7 @@ module Homebrew
   end
 
   def generate_cmd_manpages(glob)
-    cmd_paths = Pathname.glob(glob)
+    cmd_paths = Pathname.glob(glob).sort
     man_page_lines = []
     cmd_paths.each do |cmd_path|
       begin

docs/Manpage.md

@@ -1030,26 +1030,26 @@ Override warnings and enable potentially unsafe operations.
   * `services` *`command`*:
     Integrates Homebrew formulae with macOS' `launchctl` manager.
 
-    [`sudo`] `brew services list`:
-    List all running services for the current user (or root).
+    [*`sudo`*] `brew services list`
+    List all running services for the current user (or *`root`*)
 
-    [`sudo`] `brew services run` (*`formula`*|`--all`):
-    Run the service *`formula`* without registering to launch at login (or boot).
+    [*`sudo`*] `brew services run` *`formula|--all`*
+    Run the service *`formula`* without starting at login (or boot).
 
-    [`sudo`] `brew services start` (*`formula`*|`--all`):
-    Start the service *`formula`* immediately and register it to launch at login (or boot).
+    [*`sudo`*] `brew services` `start` *`formula|--all`*
+    Start the service *`formula`* immediately and register it to launch at login (or *`boot`*).
 
-    [`sudo`] `brew services stop` (*`formula`*|`--all`):
-    Stop the service *`formula`* immediately and unregister it from launching at login (or boot).
+    [*`sudo`*] `brew services` `stop` *`formula|--all`*
+    Stop the service *`formula`* immediately and unregister it from launching at login (or *`boot`*).
 
-    [`sudo`] `brew services restart` (*`formula`*|`--all`):
-    Stop (if necessary) and start the service *`formula`* immediately and register it to launch at login (or boot).
+    [*`sudo`*] `brew services` `restart` *`formula|--all`*
+    Stop (if necessary) and start the service immediately and register it to launch at login (or *`boot`*).
 
-    [`sudo`] `brew services cleanup`:
+    [*`sudo`*] `brew services` `cleanup`
     Remove all unused services.
 
     If `sudo` is passed, operate on `/Library/LaunchDaemons` (started at boot).
-    Otherwise, operate on `~/Library/LaunchAgents` (started at login).
+    Otherwise, operate on `~/Library/LaunchAgents (started at login)`.
 
     **Homebrew/homebrew-services**: <https://github.com/Homebrew/homebrew-services>
 
@@ -1300,7 +1300,7 @@ Homebrew/brew's Linux support (and Linuxbrew) maintainers are Michka Popoff and
 
 Homebrew/homebrew-core's other current maintainers are Claudia, Michka Popoff, Shaun Jackman, Chongyu Zhu, commitay, Izaak Beekman, Sean Molenaar, Jan Viljanen, Viktor Szakats, FX Coudert, Steven Peters, JCount, Misty De Meo and Tom Schoonjans.
 
-Former maintainers with significant contributions include Dominyk Tiller, Tim Smith, Baptiste Fontaine, Xu Cheng, Martin Afanasjew,  Brett Koonce, Charlie Sharpsteen, Jack Nagel, Adam Vandenberg, Andrew Janke, Alex Dunn, neutric, Tomasz Pajor, Uladzislau Shablinski, Alyssa Ross, ilovezfs and Homebrew's creator: Max Howell.
+Former maintainers with significant contributions include Dominyk Tiller, Tim Smith, Baptiste Fontaine, Xu Cheng, Martin Afanasjew, Brett Koonce, Charlie Sharpsteen, Jack Nagel, Adam Vandenberg, Andrew Janke, Alex Dunn, neutric, Tomasz Pajor, Uladzislau Shablinski, Alyssa Ross, ilovezfs and Homebrew's creator: Max Howell.
 
 ## BUGS
 

manpages/brew.1

@@ -1156,31 +1156,25 @@ Install macOS applications distributed as binaries\.
 Integrates Homebrew formulae with macOS\' \fBlaunchctl\fR manager\.
 .
 .IP
-[\fBsudo\fR] \fBbrew services list\fR
-    List all running services for the current user (or root)\.
+[\fIsudo\fR] \fBbrew services list\fR List all running services for the current user (or \fIroot\fR)
 .
 .IP
-[\fBsudo\fR] \fBbrew services run\fR (\fIformula\fR|\fB\-\-all\fR)
-    Run the service \fIformula\fR without registering to launch at login (or boot)\.
+[\fIsudo\fR] \fBbrew services run\fR \fIformula|\-\-all\fR Run the service \fIformula\fR without starting at login (or boot)\.
 .
 .IP
-[\fBsudo\fR] \fBbrew services start\fR (\fIformula\fR|\fB\-\-all\fR)
-    Start the service \fIformula\fR immediately and register it to launch at login (or boot)\.
+[\fIsudo\fR] \fBbrew services\fR \fBstart\fR \fIformula|\-\-all\fR Start the service \fIformula\fR immediately and register it to launch at login (or \fIboot\fR)\.
 .
 .IP
-[\fBsudo\fR] \fBbrew services stop\fR (\fIformula\fR|\fB\-\-all\fR)
-    Stop the service \fIformula\fR immediately and unregister it from launching at login (or boot)\.
+[\fIsudo\fR] \fBbrew services\fR \fBstop\fR \fIformula|\-\-all\fR Stop the service \fIformula\fR immediately and unregister it from launching at login (or \fIboot\fR)\.
 .
 .IP
-[\fBsudo\fR] \fBbrew services restart\fR (\fIformula\fR|\fB\-\-all\fR)
-    Stop (if necessary) and start the service \fIformula\fR immediately and register it to launch at login (or boot)\.
+[\fIsudo\fR] \fBbrew services\fR \fBrestart\fR \fIformula|\-\-all\fR Stop (if necessary) and start the service immediately and register it to launch at login (or \fIboot\fR)\.
 .
 .IP
-[\fBsudo\fR] \fBbrew services cleanup\fR
-    Remove all unused services\.
+[\fIsudo\fR] \fBbrew services\fR \fBcleanup\fR Remove all unused services\.
 .
 .IP
-If \fBsudo\fR is passed, operate on \fB/Library/LaunchDaemons\fR (started at boot)\. Otherwise, operate on \fB~/Library/LaunchAgents\fR (started at login)\.
+If \fBsudo\fR is passed, operate on \fB/Library/LaunchDaemons\fR (started at boot)\. Otherwise, operate on \fB~/Library/LaunchAgents (started at login)\fR\.
 .
 .IP
 \fBHomebrew/homebrew\-services\fR