mirror of https://github.com/mkerrisk/man-pages
Reformat headings
This commit is contained in:
parent
1ce284ecb0
commit
446a4bc839
62
man7/uri.7
62
man7/uri.7
|
@ -105,7 +105,7 @@ devicename colons with the vertical bar ("|") in URIs, so "C:" becomes "C|".
|
|||
A fragment identifier, if included, refers to a particular named portion
|
||||
(fragment) of a resource; text after a '#' identifies the fragment.
|
||||
A URI beginning with '#' refers to that fragment in the current resource.
|
||||
.SH USAGE
|
||||
.SS Usage
|
||||
There are many different URI schemes, each with specific
|
||||
additional rules and meanings, but they are intentionally made to be
|
||||
as similar as possible.
|
||||
|
@ -136,7 +136,9 @@ Here are some of the most common schemes in use on Unix-like systems
|
|||
that are understood by many tools.
|
||||
Note that many tools using URIs also have internal schemes or specialized
|
||||
schemes; see those tools' documentation for information on those schemes.
|
||||
.SS "http \- Web (HTTP) server"
|
||||
.PP
|
||||
.B "http \- Web (HTTP) server"
|
||||
.PP
|
||||
.RI http:// ip_server / path
|
||||
.br
|
||||
.RI http:// ip_server / path ? query
|
||||
|
@ -169,7 +171,9 @@ interaction mechanism (called POST) which does
|
|||
not include the data in the URI.
|
||||
See the Common Gateway Interface specification at
|
||||
<http://www.w3.org/CGI> for more information.
|
||||
.SS "ftp \- File Transfer Protocol (FTP)"
|
||||
.PP
|
||||
.B "ftp \- File Transfer Protocol (FTP)"
|
||||
.PP
|
||||
.RI ftp:// ip_server / path
|
||||
.PP
|
||||
This is a URL accessing a file through the file transfer protocol (FTP).
|
||||
|
@ -179,7 +183,9 @@ in that case many clients provide as the password the requestor's
|
|||
Internet email address.
|
||||
An example is
|
||||
<ftp://ftp.is.co.za/rfc/rfc1808.txt>.
|
||||
.SS "gopher \- Gopher server"
|
||||
.PP
|
||||
.B "gopher \- Gopher server"
|
||||
.PP
|
||||
.RI gopher:// ip_server / "gophertype selector"
|
||||
.br
|
||||
.RI gopher:// ip_server / "gophertype selector" %09 search
|
||||
|
@ -202,7 +208,9 @@ In the Gopher protocol,
|
|||
Gopher selector strings are a sequence of octets which may contain
|
||||
any octets except 09 hexadecimal (US-ASCII HT or tab), 0A hexadecimal
|
||||
(US-ASCII character LF), and 0D (US-ASCII character CR).
|
||||
.SS "mailto \- Email address"
|
||||
.PP
|
||||
.B "mailto \- Email address"
|
||||
.PP
|
||||
.RI mailto: email-address
|
||||
.PP
|
||||
This is an email address, usually of the form
|
||||
|
@ -212,7 +220,9 @@ See
|
|||
for more information on the correct format of an email address.
|
||||
Note that any % character must be rewritten as %25.
|
||||
An example is <mailto:dwheeler@dwheeler.com>.
|
||||
.SS "news \- Newsgroup or News message"
|
||||
.PP
|
||||
.B "news \- Newsgroup or News message"
|
||||
.PP
|
||||
.RI news: newsgroup-name
|
||||
.br
|
||||
.RI news: message-id
|
||||
|
@ -236,7 +246,9 @@ and ">"; it takes the form
|
|||
.IR unique @ full_domain_name .
|
||||
A message identifier may be distinguished from a news group name by the
|
||||
presence of the "@" character.
|
||||
.SS "telnet \- Telnet login"
|
||||
.PP
|
||||
.B "telnet \- Telnet login"
|
||||
.PP
|
||||
.RI telnet:// ip_server /
|
||||
.PP
|
||||
The Telnet URL scheme is used to designate interactive text services that
|
||||
|
@ -244,7 +256,9 @@ may be accessed by the Telnet protocol.
|
|||
The final "/" character may be omitted.
|
||||
The default port is 23.
|
||||
An example is <telnet://melvyl.ucop.edu/>.
|
||||
.SS "file \- Normal file"
|
||||
.PP
|
||||
.B "file \- Normal file"
|
||||
.PP
|
||||
.RI file:// ip_server / path_segments
|
||||
.br
|
||||
.RI file: path_segments
|
||||
|
@ -279,7 +293,9 @@ Note that if you really mean to say "start from the current location," don't
|
|||
specify the scheme at all; use a relative address like <../test.txt>,
|
||||
which has the side-effect of being scheme-independent.
|
||||
An example of this scheme is <file:///etc/passwd>.
|
||||
.SS "man \- Man page documentation"
|
||||
.PP
|
||||
.B "man \- Man page documentation"
|
||||
.PP
|
||||
.RI man: command-name
|
||||
.br
|
||||
.RI man: command-name ( section )
|
||||
|
@ -292,7 +308,9 @@ for more information on the meaning of the section numbers.
|
|||
This URI scheme is unique to Unix-like systems (such as Linux)
|
||||
and is not currently registered by the IETF.
|
||||
An example is <man:ls(1)>.
|
||||
.SS "info \- Info page documentation"
|
||||
.PP
|
||||
.B "info \- Info page documentation"
|
||||
.PP
|
||||
.RI info: virtual-filename
|
||||
.br
|
||||
.RI info: virtual-filename # nodename
|
||||
|
@ -319,7 +337,9 @@ In both GNOME and KDE, if the form without the nodename is used the
|
|||
nodename is assumed to be "Top".
|
||||
Examples of the GNOME format are <info:gcc> and <info:gcc#G++_and_GCC>.
|
||||
Examples of the KDE format are <info:(gcc)> and <info:(gcc)G++ and GCC>.
|
||||
.SS "whatis \- Documentation search"
|
||||
.PP
|
||||
.B "whatis \- Documentation search"
|
||||
.PP
|
||||
.RI whatis: string
|
||||
.PP
|
||||
This scheme searches the database of short (one-line) descriptions of
|
||||
|
@ -329,12 +349,16 @@ See
|
|||
.BR whatis (1).
|
||||
This URI scheme is unique to Unix-like systems (such as Linux)
|
||||
and is not currently registered by the IETF.
|
||||
.SS "ghelp \- GNOME help documentation"
|
||||
.PP
|
||||
.B "ghelp \- GNOME help documentation"
|
||||
.PP
|
||||
.RI ghelp: name-of-application
|
||||
.PP
|
||||
This loads GNOME help for the given application.
|
||||
Note that not much documentation currently exists in this format.
|
||||
.SS "ldap \- Lightweight Directory Access Protocol"
|
||||
.PP
|
||||
.B "ldap \- Lightweight Directory Access Protocol"
|
||||
.PP
|
||||
.RI ldap:// hostport
|
||||
.br
|
||||
.RI ldap:// hostport /
|
||||
|
@ -415,7 +439,9 @@ with common name (cn) "Babs Jensen" at University of Michigan, request:
|
|||
.nf
|
||||
ldap://host.com:6666/o=University%20of%20Michigan,c=US??sub?(cn=Babs%20Jensen)
|
||||
.fi
|
||||
.SS "wais \- Wide Area Information Servers"
|
||||
.PP
|
||||
.B "wais \- Wide Area Information Servers"
|
||||
.PP
|
||||
.RI wais:// hostport / database
|
||||
.br
|
||||
.RI wais:// hostport / database ? search
|
||||
|
@ -440,7 +466,9 @@ database to be retrieved.
|
|||
is the WAIS designation of the type of the object and
|
||||
.I wpath
|
||||
is the WAIS document-id.
|
||||
.SS "other schemes"
|
||||
.PP
|
||||
.B "other schemes"
|
||||
.PP
|
||||
There are many other URI schemes.
|
||||
Most tools that accept URIs support a set of internal URIs
|
||||
(e.g., Mozilla has the about: scheme for internal information,
|
||||
|
@ -454,7 +482,7 @@ URNs are to be supported by the urn: scheme, with a hierarchical name space
|
|||
(e.g., urn:ietf:... would identify IETF documents); at this time
|
||||
URNs are not widely implemented.
|
||||
Not all tools support all schemes.
|
||||
.SH "CHARACTER ENCODING"
|
||||
.SS "Character Encoding"
|
||||
.PP
|
||||
URIs use a limited number of characters so that they can be
|
||||
typed in and used in a variety of situations.
|
||||
|
@ -504,7 +532,7 @@ translate the character sequences into UTF-8 (IETF RFC\ 2279) \(em see
|
|||
.IP 2.
|
||||
use the URI escaping mechanism, that is,
|
||||
use the %HH encoding for unsafe octets.
|
||||
.SH "WRITING A URI"
|
||||
.SS "Writing a URI"
|
||||
When written, URIs should be placed inside double quotes
|
||||
(e.g., "http://www.kernelnotes.org"),
|
||||
enclosed in angle brackets (e.g., <http://lwn.net>),
|
||||
|
|
Loading…
Reference in New Issue