autodoc.git / traditional.xml

autodoc.git/traditional.xml:1:   <?xml version='1.0' encoding='utf-8'?> - <manual time-stamp='2019-05-04' version='Pike v8.1.13'> + <manual time-stamp='2019-05-05' version='Pike v8.1.13'>    <dir name='./traditional_manual'>    <file name='./traditional_manual/index.html'>    <chapter title='Table of Contents' unnumbered='1'>    <dl><dt><url href='index.html'>Table of Contents</url></dt>   <dt><url href='chapter_1.html'>1. Introduction</url></dt>   <dd><url href='chapter_1.html#1'>1.1. Overview</url></dd>   <dd><url href='chapter_1.html#2'>1.2. The history of Pike</url></dd>   <dd><url href='chapter_1.html#3'>1.3. A comparison with other languages</url></dd>   <dd><url href='chapter_1.html#4'>1.4. What is Pike</url></dd>   <dd><url href='chapter_1.html#5'>1.5. Pike License</url></dd>
autodoc.git/traditional.xml:18935:   <variable name='lr_error'><type><int/></type></variable>   </docgroup>   <docgroup homogen-name='make_parser' homogen-type='method'><doc><text><p>Compiles the parser-specification given in the first argument.    Named actions are taken from the object if available, otherwise    left as is.</p>   </text><group><bugs/><text><p>Returns error-code in both GrammarParser.error and    return_value-&gt;lr_error.</p>   </text></group></doc>   <method name='make_parser'>   <arguments><argument name='str'><type><string/></type></argument><argument name='m'><type><or><object resolved='predef::Parser.LR.GrammarParser.make_parser'/><void/></or></type></argument></arguments> - <returntype><object resolved='predef::Parser.LR.Parser'>Parser</object></returntype> + <returntype><object resolved='predef::Parser'>Parser</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='make_parser_from_file' homogen-type='method'><doc><text><p>Compiles the file specified in the first argument into an LR parser.</p>   </text><group><seealso/><text><p><ref resolved='predef::Parser.LR.GrammarParser.make_parser'>make_parser</ref></p>   </text></group></doc>   <method name='make_parser_from_file'>   <arguments><argument name='fname'><type><string/></type></argument><argument name='m'><type><or><object resolved='predef::Parser.LR.GrammarParser.make_parser_from_file'/><void/></or></type></argument></arguments> - <returntype><or><int/><object resolved='predef::Parser.LR.Parser'>Parser</object></or></returntype> + <returntype><or><int/><object resolved='predef::Parser'>Parser</object></or></returntype>   </method>   </docgroup>   </module>   <class name='Parser'>   <doc><text><p>This object implements an LALR(1) parser and compiler.</p>   <p> Normal use of this object would be:</p>   <p> <pre>    set_error_handler    {add_rule, set_priority, set_associativity}*    set_symbol_to_string
autodoc.git/traditional.xml:31450:    string c = auth-&gt;challenge();    request-&gt;response_and_finish( ([ "error":401,    "extra_heads" : ([    "WWW-Authenticate":c,    ]) ]) );    });    return authenticated;    }</p>   </text></group></doc>   <docgroup homogen-name='authenticate' homogen-type='method'><doc><text><p>Authenticate a request.</p> - </text><group><param name='string'/><text><p>The value of the Authorization header. Zero is acceptable, but + </text><group><param name='hdr'/><text><p>The value of the Authorization header. Zero is acceptable, but    will produce an unconditional rejection.</p> - </text></group><group><param name='string'/><text><p>This is the HTTP method used, typically "GET" or "POST".</p> - </text></group><group><param name='string'/><text><p>This is the path of the request.</p> + </text></group><group><param name='method'/><text><p>This is the HTTP method used, typically "GET" or "POST".</p> + </text></group><group><param name='path'/><text><p>This is the path of the request.</p>   </text></group></doc>   <method name='authenticate'>   <arguments><argument name='hdr'><type><string/></type></argument><argument name='method'><type><string/></type></argument><argument name='path'><type><string/></type></argument></arguments>   <returntype><object resolved='predef::Concurrent.Future'>Concurrent.Future</object></returntype>   </method>   </docgroup>   <docgroup homogen-name='challenge' homogen-type='method'><doc><text><p>Creates a challenge header value for the WWW-Authenticate header    in 401 responses.</p>   </text></doc>   <method name='challenge'>   <arguments/> - <returntype><string/></returntype> + <returntype><string><min>0</min><max>127</max></string></returntype>   </method>   </docgroup> - <docgroup homogen-name='create' homogen-type='method'> + <docgroup homogen-name='create' homogen-type='method'><doc><group><param name='realm'/><text><p>The realm to be authenticated.</p> + </text></group><group><param name='key'/><text><p>If this key is set all challanges are verified against +  signature using this key. The key can be any 8-bit string, but +  should be the same across multiple instances on the same +  domain, and over time.</p> + </text></group></doc>   <method name='create'><modifiers><protected/></modifiers> - <arguments><argument name='realm'><type><string/></type></argument></arguments> + <arguments><argument name='realm'><type><string><min>0</min><max>255</max></string></type></argument><argument name='key'><type><or><void/><string><min>0</min><max>255</max></string></or></type></argument></arguments>   <returntype><void/></returntype>   </method>   </docgroup>   <docgroup homogen-name='get_hashed_password' homogen-type='method'><doc><text><p>Function intended to be overloaded that returns a future that    will resolved to the given users hashed password. Overloading    this function will prevent <ref resolved='predef::Protocols.HTTP.Authentication.DigestMD5.get_password'>get_password</ref> from being called.</p>   </text></doc>   <method name='get_hashed_password'>   <arguments><argument name='user'><type><string/></type></argument><argument name='nonce'><type><string/></type></argument><argument name='cnonce'><type><string/></type></argument></arguments>   <returntype><object resolved='predef::Concurrent.Future'>Concurrent.Future</object></returntype>
autodoc.git/traditional.xml:31492:   </docgroup>   <docgroup homogen-name='get_password' homogen-type='method'><doc><text><p>Function intended to be overloaded that returns a future that    will resolve to the given users password.</p>   </text><group><seealso/><text><p><ref resolved='predef::Protocols.HTTP.Authentication.DigestMD5.get_hashed_password'>get_hashed_password</ref></p>   </text></group></doc>   <method name='get_password'>   <arguments><argument name='user'><type><string/></type></argument></arguments>   <returntype><object resolved='predef::Concurrent.Future'>Concurrent.Future</object></returntype>   </method>   </docgroup> - <docgroup homogen-name='realm' homogen-type='variable'> - <variable name='realm'><type><string/></type></variable> - </docgroup> +    <docgroup homogen-name='split_response' homogen-type='method'><doc><text><p>Split client generated Authorization header into its parts.</p>   </text></doc>   <method name='split_response'>   <arguments><argument name='hdr'><type><string/></type></argument></arguments>   <returntype><mapping><indextype><string/></indextype><valuetype><string/></valuetype></mapping></returntype>   </method>   </docgroup>   </class>   </module>   <module name='Promise'>