as-accounts.5

Fri, 28 Nov 2008 11:21:08 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Fri, 28 Nov 2008 11:21:08 +0100
changeset 1
d64aaa7d146f
permissions
-rw-r--r--

Fork project trunk at version 0.7.7 to maintain for future usage.
The original Cable & Wireless development team no longer exists.
The OSSP CVS repository is unavailable (cvs co ossp-pkg/as fails),
however http://cvs.ossp.org/dirview?d=ossp-pkg/as/as-gui is working.

     1 .\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
     2 .\"
     3 .\" Standard preamble:
     4 .\" ========================================================================
     5 .de Sh \" Subsection heading
     6 .br
     7 .if t .Sp
     8 .ne 5
     9 .PP
    10 \fB\\$1\fR
    11 .PP
    12 ..
    13 .de Sp \" Vertical space (when we can't use .PP)
    14 .if t .sp .5v
    15 .if n .sp
    16 ..
    17 .de Vb \" Begin verbatim text
    18 .ft CW
    19 .nf
    20 .ne \\$1
    21 ..
    22 .de Ve \" End verbatim text
    23 .ft R
    24 .fi
    25 ..
    26 .\" Set up some character translations and predefined strings.  \*(-- will
    27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
    28 .\" double quote, and \*(R" will give a right double quote.  | will give a
    29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
    30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
    31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
    32 .tr \(*W-|\(bv\*(Tr
    33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
    34 .ie n \{\
    35 .    ds -- \(*W-
    36 .    ds PI pi
    37 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
    38 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
    39 .    ds L" ""
    40 .    ds R" ""
    41 .    ds C` 
    42 .    ds C' 
    43 'br\}
    44 .el\{\
    45 .    ds -- \|\(em\|
    46 .    ds PI \(*p
    47 .    ds L" ``
    48 .    ds R" ''
    49 'br\}
    50 .\"
    51 .\" If the F register is turned on, we'll generate index entries on stderr for
    52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
    53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
    54 .\" output yourself in some meaningful fashion.
    55 .if \nF \{\
    56 .    de IX
    57 .    tm Index:\\$1\t\\n%\t"\\$2"
    58 ..
    59 .    nr % 0
    60 .    rr F
    61 .\}
    62 .\"
    63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
    64 .\" way too many mistakes in technical documents.
    65 .hy 0
    66 .if n .na
    67 .\"
    68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
    69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
    70 .    \" fudge factors for nroff and troff
    71 .if n \{\
    72 .    ds #H 0
    73 .    ds #V .8m
    74 .    ds #F .3m
    75 .    ds #[ \f1
    76 .    ds #] \fP
    77 .\}
    78 .if t \{\
    79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
    80 .    ds #V .6m
    81 .    ds #F 0
    82 .    ds #[ \&
    83 .    ds #] \&
    84 .\}
    85 .    \" simple accents for nroff and troff
    86 .if n \{\
    87 .    ds ' \&
    88 .    ds ` \&
    89 .    ds ^ \&
    90 .    ds , \&
    91 .    ds ~ ~
    92 .    ds /
    93 .\}
    94 .if t \{\
    95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
    96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
    97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
    98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
    99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
   100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
   101 .\}
   102 .    \" troff and (daisy-wheel) nroff accents
   103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
   104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
   105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
   106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
   107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
   108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
   109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
   110 .ds ae a\h'-(\w'a'u*4/10)'e
   111 .ds Ae A\h'-(\w'A'u*4/10)'E
   112 .    \" corrections for vroff
   113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
   114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
   115 .    \" for low resolution devices (crt and lpr)
   116 .if \n(.H>23 .if \n(.V>19 \
   117 \{\
   118 .    ds : e
   119 .    ds 8 ss
   120 .    ds o a
   121 .    ds d- d\h'-1'\(ga
   122 .    ds D- D\h'-1'\(hy
   123 .    ds th \o'bp'
   124 .    ds Th \o'LP'
   125 .    ds ae ae
   126 .    ds Ae AE
   127 .\}
   128 .rm #[ #] #H #V #F C
   129 .\" ========================================================================
   130 .\"
   131 .IX Title "AS-ACCOUNTS 5"
   132 .TH AS-ACCOUNTS 5 "as-gui 0.7.2" "06-Mar-2003" "AS Accounts File"
   133 .SH "NAME"
   134 \&\fBas\-accounts\fR \- accounting system accounts document format
   135 .SH "DESCRIPTION"
   136 .IX Header "DESCRIPTION"
   137 The \fBas-gui\fR application specifies a user entry as including many individual
   138 pieces of information (see as\-events.5). One of these is the account,
   139 describing a task on which the user worked. While the account field may
   140 contain free text, there are a number of atomic values which are typical in
   141 the work atmosphere. The \fBas-gui\fR client reads a file of such values to offer
   142 the user a listing in which to choose from. This file is called the
   143 \&\fBas-accounts\fR file, and is typically named \fIaccounts\fR. Its name and location
   144 are arbitrary and may be changed through the user preferences.
   145 .SH "FILE FORMAT"
   146 .IX Header "FILE FORMAT"
   147 The \fBas-accounts\fR file contains \s-1ASCII\s0 text. The first line consists of an
   148 identifier to associate the file type and version. Following text may contain
   149 white space, comments, and data tuples.
   150 .SH "GRAMMAR"
   151 .IX Header "GRAMMAR"
   152 \&\fBaccounts\fR    ::= \fBaccid\fR \fBacclist\fR
   153 .PP
   154 \&\fBaccid\fR       ::= \*(L"%!AS\-ACCOUNTS\-\*(R" [0\-9] '.' [0\-9]
   155 .PP
   156 \&\fBacclist\fR     ::= \fBacclist\fR | \fBacctuple\fR | \fBcomment\fR | \s-1EMPTY\s0
   157 .PP
   158 \&\fBcomment\fR     ::= ($#.*)
   159 .PP
   160 \&\fBacctuple\fR    ::= \fBacctype\fR \fBaccfull\fR | \fBacctype\fR \fBaccfull\fR \fBcomment\fR
   161 .PP
   162 \&\fBaccfull\fR     ::= \fBaccfull\fR | \fBaccpart\fR
   163 .PP
   164 \&\fBaccpart\fR     ::= \fBaccsep\fR \fBacctext\fR
   165 .PP
   166 \&\fBacctype\fR     ::= [\s-1RM\s0]
   167 .PP
   168 \&\fBaccsep\fR      ::= '/'
   169 .PP
   170 \&\fBacctext\fR     ::= [a\-zA\-Z0\-9_\-]*
   171 .SH "EXAMPLE"
   172 .IX Header "EXAMPLE"
   173 A typical \fBas-accounts\fR file might look like this:
   174 .PP
   175 %!AS\-ACCOUNTS\-0.6
   176 .PP
   177 ## Internet Services (\s-1IS\s0) department ##
   178 .PP
   179 # General
   180 .PP
   181 R /is/common/meeting         # Specify type
   182 .PP
   183 R /is/common/meeting/weekly  # A weekly meeting
   184 .PP
   185 # Special
   186 .PP
   187 R /is/sales/absence/illness  # Approved absence (illness)
   188 .PP
   189 R /is/sales/absence/vacation # Approved absence (vacation)
   190 .SH "SEE ALSO"
   191 .IX Header "SEE ALSO"
   192 \&\fIas\-gui\fR\|(1),
   193 \&\fIas\-gui.conf\fR\|(5),
   194 \&\fIas\-events\fR\|(5)

mercurial