Return to INFO CVS log

Up to [CSRG BSD Unix] / 43BSDReno / bin / adb / common_source

Annotation of 43BSDReno/bin/adb/common_source/INFO, revision 1.1

1.1     ! root        1:        INFORMATION ABOUT ADB INTERNALS
        !             2: 
        !             3:        23 August 1988, Chris Torek
        !             4: 
        !             5:        (This file is incomplete.)
        !             6: 
        !             7: TYPES
        !             8:        write something here.
        !             9: 
        !            10: FORMATTED OUTPUT
        !            11:        Adb has a simplified, and slightly extended, version of printf,
        !            12: called adbprintf().  adbprintf() conversion specifiers are introduced by
        !            13: the usual `%' escape.  (Beware of SCCS eating 5 and June 25, 1990 escapes.)  The
        !            14: format of a conversion-specifier is:
        !            15: 
        !            16:        [flags] [width] [`.' precision] conversion-character
        !            17: 
        !            18: The default width is 0; the default precision is -1.  The available
        !            19: flags are `-', for right adjustment within the field, and `+', which
        !            20: forces a sign on numeric conversions.  If the result of a conversion
        !            21: is narrower than the specified width, it is passed on the right (or
        !            22: left if `-') with blanks.  If a precision is given, and is not negative,
        !            23: the result of a conversion will be truncated after precision characters.
        !            24: Width and precision may be given as `*', in which case they are taken
        !            25: from an integer argument a la printf().
        !            26: 
        !            27: The conversion-characters, and the types they expect, are:
        !            28: 
        !            29:        [numeric]
        !            30:        d       prints an hword_t value as a signed decimal integer.
        !            31:        D       prints an expr_t value as a signed decimal integer.
        !            32:        u       prints an hword_t value as an unsigned decimal integer.
        !            33:        U       prints an expr_t value as an unsigned decimal integer.
        !            34:        q       prints an hword_t value as a signed octal integer.
        !            35:        Q       prints an expr_t value as a signed octal integer.
        !            36:        o       prints an hword_t value as an unsigned octal integer.
        !            37:        O       prints an expr_t value as an unsigned octal integer.
        !            38:        z       prints an hword_t value as a signed hexadecimal integer.
        !            39:        Z       prints an expr_t value as a signed hexadecimal integer.
        !            40:        x       prints an hword_t value as an unsigned hexadecimal integer.
        !            41:        X       prints an expr_t value as an unsigned hexadecimal integer.
        !            42:        r       prints an hword_t value in the current radix.
        !            43:        R       prints an expr_t value in the current radix.
        !            44:        v       prints an hword_t value in signed variant of current radix.
        !            45:        V       prints an expr_t value in signed variant of current radix.
        !            46: 
        !            47:        [non-numeric]
        !            48:        c       prints a character.
        !            49: 
        !            50:        s       prints a string.
        !            51: 
        !            52:        m       prints nothing; hence %<width>m prints <width> spaces.
        !            53: 
        !            54:        t       prints nothing, but adjusts the width such that it
        !            55:                becomes a tabstop.  Thus %24t moves to the next column
        !            56:                that is a multiple of 24, and %8t acts like \t would
        !            57:                if \t were implemented in adb.
        !            58: 
        !            59:        [special]
        !            60:        ?       converts an integer value, then applies a second
        !            61:                conversion-specifier.  If integer was zero, the
        !            62:                output from the second conversion-specifier is
        !            63:                suppressed.  For instance, %?s converts one integer
        !            64:                and one string, and prints the string only if the
        !            65:                integer is nonzero (and the pointer is not evaluated).
        !            66:                Thus `adbprintf("%?s", s!=NULL, s)' prints the string
        !            67:                s if and only if the pointer s is not NULL.  `?'
        !            68:                conversions may be nested: ("%??x", a, b, c) prints
        !            69:                c only if both a and b are nonzero.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.