diff --git a/Library/Homebrew/dev-cmd/man.rb b/Library/Homebrew/dev-cmd/man.rb index a93e8669c0..d11780923f 100644 --- a/Library/Homebrew/dev-cmd/man.rb +++ b/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 diff --git a/docs/Manpage.md b/docs/Manpage.md index 25f9670426..ccd8423d64 100644 --- a/docs/Manpage.md +++ b/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**: @@ -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 diff --git a/manpages/brew.1 b/manpages/brew.1 index 7ca23f9647..c12753f808 100644 --- a/manpages/brew.1 +++ b/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