02/10/03 20:08:11 (20 years ago)
Nicholas Riley

appswitch 1.0b1 code changes

2 edited


  • trunk/appswitch

    • Property svn:ignore set to
  • trunk/appswitch/appswitch.1

    r85 r91  
    1 .\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples.
    2 .\"See Also:
    3 .\"man mdoc.samples for a complete listing of options
    4 .\"man mdoc for the short list of editing options
    5 .\"/usr/share/misc/mdoc.template
    6 .Dd Tue Feb 04 2003               \" DATE
    7 .Dt appswitch 1      \" Program name and manual section number
    8 .Os Darwin
    9 .Sh NAME                 \" Section Header - required - don't modify
    10 .Nm appswitch,
    11 .\" The following lines are read in generating the apropos(man -k) database. Use only key
    12 .\" words here as the database is built based on the words here and in the .ND line.
    13 .Nm Other_name_for_same_program(),
    14 .Nm Yet another name for the same program.
    15 .\" Use .Nm macro to designate other names for the documented program.
    16 .Nd This line parsed for whatis database.
    17 .Sh SYNOPSIS             \" Section Header - required - don't modify
     1.Dd Mon Feb 10 2003               \" DATE
     2.Dt APPSWITCH 1 LOCAL      \" Program name and manual section number
     3.Os appswitch 1.0b1
     4.Sh NAME
     5.Nm appswitch
     6.Nd switch, hide, show, kill or list Mac OS X applications
     7.Sh SYNOPSIS
     8.Nm appswitch
     9.Op Fl sShHkFlP          \" [-sShHkFlP]
     10.Op Fl c Ar creator      \" [-c creator]
     11.Op Fl i Ar bundleID     \" [-i bundleID]
     12.Op Fl a Ar name         \" [-a name]
     13.Op Fl p Ar pid          \" [-p pid]
     14.Op Ar path              \" [path]
    19 .Op Fl abcd              \" [-abcd]
    20 .Op Fl a Ar path         \" [-a path]
    21 .Op Ar file              \" [file]
    22 .Op Ar                   \" [file ...]
    23 .Ar arg0                 \" Underlined argument - use .Ar anywhere to underline
    24 arg2 ...                 \" Arguments
    25 .Sh DESCRIPTION          \" Section Header - required - don't modify
    26 Use the .Nm macro to refer to your program throughout the man page like such:
     17controls the ordering and visibility of Mac OS X application windows.
    28 Underlining is accomplished with the .Ar macro like this:
    29 .Ar underlined text .
    30 .Pp                      \" Inserts a space
    31 A list of items with descriptions:
    32 .Bl -tag -width -indent  \" Begins a tagged list
    33 .It item a               \" Each item preceded by .It macro
    34 Description of item a
    35 .It item b
    36 Description of item b
    37 .El                      \" Ends the list
    38 .Pp
    39 A list of flags and their descriptions:
    40 .Bl -tag -width -indent  \" Differs from above in tag removed
    41 .It Fl a                 \"-a flag as a list item
    42 Description of -a flag
    43 .It Fl b
    44 Description of -b flag
    45 .El                      \" Ends the list
    46 .Pp
    47 .\" .Sh ENVIRONMENT      \" May not be needed
    48 .\" .Bl -tag -width "ENV_VAR_1" -indent \" ENV_VAR_1 is width of the string ENV_VAR_1
    49 .\" .It Ev ENV_VAR_1
    50 .\" Description of ENV_VAR_1
    51 .\" .It Ev ENV_VAR_2
    52 .\" Description of ENV_VAR_2
    53 .\" .El                     
    54 .Sh FILES                \" File used or created by the topic of the man page
    55 .Bl -tag -width "/Users/joeuser/Library/really_long_file_name" -compact
    56 .It Pa /usr/share/file_name
    57 FILE_1description
    58 .It Pa /Users/joeuser/Library/really_long_file_name
    59 FILE_2 description
    60 .\" .Sh DIAGNOSTICS       \" May not be needed
    61 .\" .Bl -diag
    62 .\" .It Diagnostic Tag
    63 .\" Diagnostic informtion here.
    64 .\" .It Diagnostic Tag
    65 .\" Diagnostic informtion here.
    66 .\" .El
     19can also list or kill running applications.
     20.Ss Matching options
     21Matching identifies one or more applications to manipulate.
     22.Bl -tag -width -indent
     23.It Fl c Ar creator
     24Match by creator (a four-character code, also known as a signature).
     25.It Fl i Ar bundle ID
     26Match by bundle identifier, usually consisting of the reversed dot
     27(.)-separated components of the application developer's Internet domain
     28name, followed by the application name.  For example, the Finder's
     29bundle identifier is
     30.Ar com.apple.Finder .
     31Bundle identifiers are not case-sensitive.
     32.It Fl p Ar pid
     33Match by process identifier, a positive number.
     34.It Ar path
     35Match by bundle path.  For packaged applications, this is the package
     36directory whose name typically has the .app extension, for example
     37.Ar /Applications/TextEdit.app
     38for the default installation location of TextEdit.  For non-packaged
     39applications, this is the path to the executable itself.
     41.Ss Application actions
     42These actions apply to the matched application. If multiple
     43applications match the supplied criteria, only the first matching
     44application is acted upon.  The list option
     45.Fl l
     46displays all matching applications.
     47.Bl -tag -width -indent
     48.It Fl s
     49Show the application, making the application's windows frontmost. Do
     50not switch to the application.
     51.It Fl h
     52Hide the application's windows.
     53.It Fl k
     54Kill (force quit) the application.
     55.It Fl l
     56List applications in a format similar to that of
     57.Xr ps 1 . The columns of the listing are as follows:
     58.Bl -tag -width indent
     59.It PSN
     60The process serial number of the application.  Process serial numbers
     61are unique identifiers among both native Mac OS X and Classic
     63.It PID
     64The process identifier, a positive number which uniquely identifies
     65native Mac OS X processes, usable with the
     66.Fl p
     67matching option.  Because all Classic applications run inside
     68TruBlueEnvironment, a single Mac OS X process, their process
     69identifiers appear as -1.
     70.It TYPE
     71The four-character code identifying the application's type,
     72usually 'APPL' for most applications or 'FNDR' for the Finder.
     73Classic applications include additional types such as 'appe'
     74and 'APPC' for applications which perform the functions of extensions
     75and control panels, respectively.
     76.It CREA
     77The four-character code identifying the application's creator, usable with the
     78.Fl c
     79matching option. Some Mac OS X applications have no creator, appearing
     80as '????'; for these applications you must use the bundle identifier,
     81name or path as match criteria.
     82.It NAME
     83The user-visible application name, usable with the
     84.Fl a
     85matching option. This field is truncated to 20 characters; the
     86remainder of longer application names is not displayed.
     87.It PATH
     88The path to the application bundle, usable with the
     89.Ar path
     90matching option. This field is truncated to the window width, or to 80
     91characters if the window width cannot be determined.
     93.It Fl p
     94Print the application's process identifier (PID), a positive number
     95and unique identifier for all applications except Classic
     98.Ss Actions
     99These actions affect all applications currently running.
     100.Bl -tag -width -indent
     101.It Fl S
     102Show all applications, layering the windows of initially hidden
     103applications on top.
     104.It Fl H
     105Hide windows of all applications other than the matched application,
     106or the frontmost application if no application has been matched.
     107.It Fl F
     108Order the current application's windows to the front.
    67110.Sh SEE ALSO
    68111.\" List links in ascending order by section, alphabetically within a section.
    69112.\" Please do not reference files that do not exist without filing a bug report
    70 .Xr a 1 ,
    71 .Xr b 1 ,
    72 .Xr c 1 ,
    73 .Xr a 2 ,
    74 .Xr b 2 ,
    75 .Xr a 3 ,
    76 .Xr b 3
    77 .\" .Sh BUGS              \" Document known, unremedied bugs
     113.Xr open 1 ,
     114.Xr launch 1 ,
     115.Xr ps 1 ,
     116.Xr kill 1 ,
     117.Xr GetFileInfo 1
     118.Sh BUGS              \" Document known, unremedied bugs
     120.Fl F
     121option may be unreliable if issued immediately after another show or
     122hide command; try inserting a
     123.Xr sleep 1
     124command before it.
     125.Sh AUTHORS
     126.An "Nicholas Riley" Aq appswitch@sabi.net
    78127.\" .Sh HISTORY           \" Document history if command behaves in a unique manner
Note: See TracChangeset for help on using the changeset viewer.