#
# This file contains the definitions for the built-in
# macros used by troff
#
# The format of the file is
#    macro <argument-list>
#
#    Arguments are:
#       |       Vertical bar
#       s       String
#       n       Numeric expression
#       c       Single character
#       f       Font specification
#       t       Three-part title
#       
#       If followed by a * they can be repeated 0 or more
#       times
#
# Anything past a # is considered a comment
br              # Break 
ad s            # Adjust margins
na              # No adjust
nf              # No fill
fi              # Fill
nh              # No hyphen
hy n            # Set hyphenation mode
hw s*           # Specify how to hyphenate words
hc c            # Hyphenation character
ce n            # Center lines
ul n            # Underline
cu n            # Continuous underline
uf f            # Select font for underline
po | n          # Page offset
ll n            # Line length
in | n          # Indent
ti | n          # Temporary indent
pl | n          # Page length
bp n            # Begin page
pn n            # Page number
ne n            # Specify need space
mk s            # Mark current location
sp | n          # Vertical space
ps n            # Point size
vs | n          # Vertical space
ls n            # Line spacing
sv n            # Save space
os              # Output saved space
ns              # Set no-space mode
rs              # Set restore-space mode
ss n            # Set character space size
cs s n n        # Constant space mode
ft f            # Specify font
fp f n          # Set font position
fz f n          # Font size request
bd f n          # Specify how to bold a font
lg n            # Select ligatures
ta n*           # Specify tabs
tc c            # Tab character
lc c            # Leader character
fc c s          # Field character
lt | n          # Title length
pc c            # Page character
tl t            # Title
so s            # Source another file
nx s            # Change to another file
pi s            # Pipe output to a program
rd s            # Read data from keyboard
ex s            # Exit
tm s*           # Send message to standard output
ds s s          # Define string
as s s          # Append string
de s s          # Define macro
.               # End of macro
rm s            # Remove macro
rn s s          # Rename macro
am s s          # Append to macro
di s            # Divert to macro
da s            # Append to diversion
wh n s          # Set place to execute macro
ch s n          # Change place macro executes
dt n s          # Set diversion trap
it n s          # Set input trap
em s            # Set macro for end of input
nr s n n        # Define number register
af s c          # Assign format
rr s            # Remove register
mc c            # Margin character
ec c            # Set escape character
eo              # Turn off escape 
cc c            # Set control character
c2              # Set second control character
tr s            # Translate characters
nm n n n n      # Line number
nn n            # No numbering
ig s            # Ignore input
pm s            # Print macros
fl              # Flush output
ab s            # Abort
ev n            # Set environment
\" s*           # Comment
/input?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24'>input</a>/<a href='/cgit.cgi/linux/net-next.git/commit/Documentation/input/gamepad.txt?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24'>gamepad.txt</a></div><div class='content'><div class='cgit-panel'><b>diff options</b><form method='get'><input type='hidden' name='h' value='nds-private-remove'/><input type='hidden' name='id' value='67245ff332064c01b760afa7a384ccda024bfd24'/><table><tr><td colspan='2'/></tr><tr><td class='label'>context:</td><td class='ctrl'><select name='context' onchange='this.form.submit();'><option value='1'>1</option><option value='2'>2</option><option value='3' selected='selected'>3</option><option value='4'>4</option><option value='5'>5</option><option value='6'>6</option><option value='7'>7</option><option value='8'>8</option><option value='9'>9</option><option value='10'>10</option><option value='15'>15</option><option value='20'>20</option><option value='25'>25</option><option value='30'>30</option><option value='35'>35</option><option value='40'>40</option></select></td></tr><tr><td class='label'>space:</td><td class='ctrl'><select name='ignorews' onchange='this.form.submit();'><option value='0' selected='selected'>include</option><option value='1'>ignore</option></select></td></tr><tr><td class='label'>mode:</td><td class='ctrl'><select name='dt' onchange='this.form.submit();'><option value='0' selected='selected'>unified</option><option value='1'>ssdiff</option><option value='2'>stat only</option></select></td></tr><tr><td/><td class='ctrl'><noscript><input type='submit' value='reload'/></noscript></td></tr></table></form></div><table summary='commit info' class='commit-info'>
<tr><th>author</th><td>Linus Torvalds &lt;torvalds@linux-foundation.org&gt;</td><td class='right'>2016-04-16 15:16:07 -0700</td></tr>
<tr><th>committer</th><td>Linus Torvalds &lt;torvalds@linux-foundation.org&gt;</td><td class='right'>2016-04-18 13:43:02 -0700</td></tr>
<tr><th>commit</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/commit/Documentation/input/gamepad.txt?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24'>67245ff332064c01b760afa7a384ccda024bfd24</a> (<a href='/cgit.cgi/linux/net-next.git/patch/Documentation/input/gamepad.txt?id=67245ff332064c01b760afa7a384ccda024bfd24'>patch</a>)</td></tr>
<tr><th>tree</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/tree/?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24'>bf77d422b16306ba9fdcf2f7e1f340a409f8a0f6</a> /<a href='/cgit.cgi/linux/net-next.git/tree/Documentation/input/gamepad.txt?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24'>Documentation/input/gamepad.txt</a></td></tr>
<tr><th>parent</th><td colspan='2' class='oid'><a href='/cgit.cgi/linux/net-next.git/commit/Documentation/input/gamepad.txt?h=nds-private-remove&amp;id=2e572599139d27db3aaf540b0d34f0a4f58dfca1'>2e572599139d27db3aaf540b0d34f0a4f58dfca1</a> (<a href='/cgit.cgi/linux/net-next.git/diff/Documentation/input/gamepad.txt?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24&amp;id2=2e572599139d27db3aaf540b0d34f0a4f58dfca1'>diff</a>)</td></tr></table>
<div class='commit-subject'>devpts: clean up interface to pty drivers</div><div class='commit-msg'>This gets rid of the horrible notion of having that

    struct inode *ptmx_inode

be the linchpin of the interface between the pty code and devpts.

By de-emphasizing the ptmx inode, a lot of things actually get cleaner,
and we will have a much saner way forward.  In particular, this will
allow us to associate with any particular devpts instance at open-time,
and not be artificially tied to one particular ptmx inode.

The patch itself is actually fairly straightforward, and apart from some
locking and return path cleanups it's pretty mechanical:

 - the interfaces that devpts exposes all take "struct pts_fs_info *"
   instead of "struct inode *ptmx_inode" now.

   NOTE! The "struct pts_fs_info" thing is a completely opaque structure
   as far as the pty driver is concerned: it's still declared entirely
   internally to devpts. So the pty code can't actually access it in any
   way, just pass it as a "cookie" to the devpts code.

 - the "look up the pts fs info" is now a single clear operation, that
   also does the reference count increment on the pts superblock.

   So "devpts_add/del_ref()" is gone, and replaced by a "lookup and get
   ref" operation (devpts_get_ref(inode)), along with a "put ref" op
   (devpts_put_ref()).

 - the pty master "tty-&gt;driver_data" field now contains the pts_fs_info,
   not the ptmx inode.

 - because we don't care about the ptmx inode any more as some kind of
   base index, the ref counting can now drop the inode games - it just
   gets the ref on the superblock.

 - the pts_fs_info now has a back-pointer to the super_block. That's so
   that we can easily look up the information we actually need. Although
   quite often, the pts fs info was actually all we wanted, and not having
   to look it up based on some magical inode makes things more
   straightforward.

In particular, now that "devpts_get_ref(inode)" operation should really
be the *only* place we need to look up what devpts instance we're
associated with, and we do it exactly once, at ptmx_open() time.

The other side of this is that one ptmx node could now be associated
with multiple different devpts instances - you could have a single
/dev/ptmx node, and then have multiple mount namespaces with their own
instances of devpts mounted on /dev/pts/.  And that's all perfectly sane
in a model where we just look up the pts instance at open time.

This will eventually allow us to get rid of our odd single-vs-multiple
pts instance model, but this patch in itself changes no semantics, only
an internal binding model.

Cc: Eric Biederman &lt;ebiederm@xmission.com&gt;
Cc: Peter Anvin &lt;hpa@zytor.com&gt;
Cc: Andy Lutomirski &lt;luto@amacapital.net&gt;
Cc: Al Viro &lt;viro@zeniv.linux.org.uk&gt;
Cc: Peter Hurley &lt;peter@hurleysoftware.com&gt;
Cc: Serge Hallyn &lt;serge.hallyn@ubuntu.com&gt;
Cc: Willy Tarreau &lt;w@1wt.eu&gt;
Cc: Aurelien Jarno &lt;aurelien@aurel32.net&gt;
Cc: Alan Cox &lt;gnomes@lxorguk.ukuu.org.uk&gt;
Cc: Jann Horn &lt;jann@thejh.net&gt;
Cc: Greg KH &lt;greg@kroah.com&gt;
Cc: Jiri Slaby &lt;jslaby@suse.com&gt;
Cc: Florian Weimer &lt;fw@deneb.enyo.de&gt;
Signed-off-by: Linus Torvalds &lt;torvalds@linux-foundation.org&gt;
</div><div class='diffstat-header'><a href='/cgit.cgi/linux/net-next.git/diff/?h=nds-private-remove&amp;id=67245ff332064c01b760afa7a384ccda024bfd24'>Diffstat</a> (limited to 'Documentation/input/gamepad.txt')</div><table summary='diffstat' class='diffstat'>