Print this page
manpage lint.

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man5/mdoc.5
          +++ new/usr/src/man/man5/mdoc.5
↓ open down ↓ 386 lines elided ↑ open up ↑
 387  387  code sets.  True independent code sets will support not only ASCII and
 388  388  Extended UNIX Codesets (EUC), but also other multi-byte encodings such as
 389  389  UTF-8 and GB2312.
 390  390  .Pp
 391  391  Generally there will be some limitations that are fairly standard.  See
 392  392  .Xr standards 5 for more information about some of these.  Most interfaces
 393  393  should support at least UTF-8 in addition to ASCII.
 394  394  .It Em INTERFACE STABILITY
 395  395  Indicates the level of commitment to the interface. Interfaces can be described
 396  396  with in the following ways:
 397      -.Bl -tag
      397 +.Bl -tag -width Ds
 398  398  .It Nm Standard
 399  399  Indicates that the interface is defined by one or more standards bodies.
 400  400  Generally, changes to the interface will be carefully managed to conform
 401  401  to the relevant standards.  These interfaces are generally the most suitable
 402  402  for use in portable programs.
 403  403  .It Nm Committed
 404  404  Indicates that the interface is intended to be preserved for the long-haul, and
 405  405  will rarely, if ever change, and never without notification (barring
 406      -extraordinary and extenuating circumstances). These interfaces are 
      406 +extraordinary and extenuating circumstances). These interfaces are
 407  407  preferred over other interfaces with the exeception of
 408  408  .Nm Standard
 409  409  interfaces.
 410  410  .It Nm Uncommitted
 411  411  Indicates that the interface may change.  Generally, changes to these interfaces
 412  412  should be infrequent, and some effort will be made to address compatibility
 413  413  considerations when changing or removing such interfaces.  However, there is
 414  414  no firm commitment to the preservation of the interface.  Most often this
 415  415  is applied to interfaces where operational experience with the interface
 416  416  is still limited and some need to change may be anticipated.
↓ open down ↓ 31 lines elided ↑ open up ↑
 448  448  .Nm Obsolete Committed
 449  449  interface is unlikely to be removed or changed, but nonetheless new use
 450  450  is discouraged (perhaps a better newer alternative is present).
 451  451  .El
 452  452  .It Em MT-LEVEL
 453  453  This section describes considerations for the interface when used within
 454  454  programs that use multiple threads.  More discussion of these considerations
 455  455  is made in the MT-Level section of
 456  456  .Xr attributes 5 .
 457  457  The interface can be described in the following ways.
 458      -.Bl -tag
      458 +.Bl -tag -width Ds
 459  459  .It Nm Safe
 460  460  Indicates the interface is safe for use within multiple threads.  There
 461  461  may be additional caveats that apply, in which case those will be
 462  462  described.  Note that some interfaces have semantics which may affect
 463  463  other threads, but these should be an intrinsic part of the interface
 464  464  rather than an unexpected side effect.  For example, closing a file in
 465  465  one thread will cause that file to be closed in all threads.
 466  466  .It Nm Unsafe
 467  467  Indicates the interface is unsuitable for concurrent use within multiple
 468  468  threads.  A threaded application may still make use of the interface, but
↓ open down ↓ 2743 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX