1.. _notation: 2 3Notational Conventions 4====================== 5 6 7The following conventions may be used in this document. 8 9 10.. container:: tablenoborder 11 12 13 .. list-table:: 14 :header-rows: 1 15 16 * - Convention 17 - Explanation 18 - Example 19 * - \ *Italic* 20 - Used for introducing new terms, denotation of terms, placeholders, or titles of manuals. 21 - The filename consists of the *basename* and the *extension*. 22 * - \ ``Monospace`` 23 - Indicates directory paths and filenames, commands and command line options, function names, methods, classes, data structures in body text, source code. 24 - \ ``ippsapi.h`` \ ``\alt\include`` Use the okCreateObjs() function to... \ ``printf("hello, world\n");`` 25 * - [ ] 26 - Items enclosed in brackets are optional. 27 - Fa[c] Indicates Fa or Fac. 28 * - { \| } 29 - Braces and vertical bars indicate the choice of one item from a selection of two or more items. 30 - X{K \| W \| P} Indicates XK, XW, or XP. 31 * - "[" "]" "{" | " }" "|" 32 - Writing a metacharacter in quotation marks negates the syntactical meaning stated above; | the character is taken as a literal. 33 - "[" X "]" [ Y ] Denotes the letter X enclosed in brackets, optionally followed by the letter Y. 34 * - ... 35 - The ellipsis indicates that the previous item can be repeated several times. 36 - \ ``filename`` ... Indicates that one or more filenames can be specified. 37 * - ,... 38 - The ellipsis preceded by a comma indicates that the previous item can be repeated several times, | separated by commas. 39 - \ ``word`` ,... Indicates that one or more words can be specified. If more than one word is specified, the words are comma-separated. 40 41 42 43 44.. container:: section 45 46 47 Class members are summarized by informal class declarations that 48 describe the class as it seems to clients, not how it is actually 49 implemented. For example, here is an informal declaration of class 50 ``Foo``: 51 52 53 :: 54 55 56 class Foo { 57 public: 58 int x(); 59 int y; 60 ~Foo(); 61 }; 62 63 64 The actual implementation might look like: 65 66 67 :: 68 69 70 namespace internal { 71 class FooBase { 72 protected: 73 int x(); 74 }; 75 76 77 class Foo_v3: protected FooBase { 78 private: 79 int internal_stuff; 80 public: 81 using FooBase::x; 82 int y; 83 }; 84 } 85 86 87 typedef internal::Foo_v3 Foo; 88 89 90 The example shows two cases where the actual implementation departs 91 from the informal declaration: 92 93 94 - ``Foo`` is actually a typedef to ``Foo_v3``. 95 96 97 - Method ``x()`` is inherited from a protected base class. 98 99 100 - The destructor is an implicit method generated by the compiler. 101 102 103 The informal declarations are intended to show you what you need to 104 know to use the class without the distraction of irrelevant clutter 105 particular to the implementation. 106 107