tools: Use hyphens instead of underscores for multi-word option names

tools/catch_exception_tool.ad

 // Copyright 2014 The Crashpad Authors. All rights reserved.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 20 matching lines @@
 'SERVICE'. The exception server is capable of receiving exceptions for
 “behavior” values of +EXCEPTION_DEFAULT+, +EXCEPTION_STATE+, and
 +EXCEPTION_STATE_IDENTITY+, with or without +MACH_EXCEPTION_CODES+ set.
 
 == Options
 
 *-f*, *--file*='FILE'::
 Information about the exception will be appended to 'FILE' instead of the
 standard output stream.
 
-*-m*, *--mach_service*='SERVICE'::
+*-m*, *--mach-service*='SERVICE'::
 Check in with the bootstrap server under the name 'SERVICE'. This service name
 may already be reserved with the bootstrap server in cases where this tool is
 started by launchd(8) as a result of a message being sent to a service declared
 in a job’s +MachServices+ dictionary (see launchd.plist(5)). The service name
 may also be completely unknown to the system.
 
 *-n*, *--nonblocking*::
 Don’t wait for an exception to occur if one is not received immediately. In
 nonblocking mode, this tool exits immediately if no exception is received. The
 default mode is blocking.
@@ skipping 13 matching lines @@
 
 *--version*::
 Output version information and exit.
 
 == Examples
 
 Run a one-shot blocking exception server registered with the bootstrap server
 under the name +svc+:
 [subs="quotes"]
 ----
-$ *catch_exception_tool --mach_service=svc --file=out &*
+$ *catch_exception_tool --mach-service=svc --file=out &*
 [1] 1233
-$ *exception_port_tool --set_handler=handler=bootstrap:svc crasher*
+$ *exception_port_tool --set-handler=handler=bootstrap:svc crasher*
 Illegal instruction: 4
-[1]+  Done    catch_exception_tool --mach_service=svc --file=out
+[1]+  Done    catch_exception_tool --mach-service=svc --file=out
 $ *cat out*
 catch_exception_tool:
 behavior EXCEPTION_DEFAULT|MACH_EXCEPTION_CODES,
 pid 1234, thread 56789, exception EXC_CRASH, codes[2] 0x4200001, 0,
 original exception EXC_BAD_INSTRUCTION, original code[0] 1,
 signal SIGILL
 ----
 
 Run an on-demand exception server started by launchd(5) available via the
 bootstrap server under the name +svc+:
 [subs="quotes"]
 ----
 $ *on_demand_service_tool --load --label=catch_exception \
-      --mach_service=svc \
-      $(which catch_exception_tool) --mach_service=svc \
+      --mach-service=svc \
+      $(which catch_exception_tool) --mach-service=svc \
       --file=/tmp/out --nonblocking --persistent*
-$ *exception_port_tool --set_handler=handler=bootstrap:svc crasher*
+$ *exception_port_tool --set-handler=handler=bootstrap:svc crasher*
 Illegal instruction: 4
 $ *on_demand_service_tool --unload --label=catch_exception*
 $ *cat /tmp/out*
 catch_exception_tool:
 behavior EXCEPTION_DEFAULT|MACH_EXCEPTION_CODES,
 pid 2468, thread 13579, exception EXC_CRASH, codes[2] 0x4200001, 0,
 original exception EXC_BAD_INSTRUCTION, original code[0] 1,
 signal SIGILL
 ----
 
 == Exit Status
 
 *0*::
 Success. In *--persistent* mode with a *--timeout* set, it is considered
 successful if at least one exception was caught when the timer expires.
 
 *1*::
 Failure, with a message printed to the standard error stream.
 
 == See Also
 
 exception_port_tool(1),
 on_demand_service_tool(1)
 
 include::man_footer.ad[]