Posted to tcl by mr_calvin at Thu Oct 05 08:43:43 GMT 2017view raw

  1. Index: doc/dom.xml
  2. ==================================================================
  3. --- doc/dom.xml
  4. +++ doc/dom.xml
  5. @@ -334,11 +334,11 @@
  6. <commanddef>
  7. <command><cmd>dom</cmd> <method>createNodeCmd</method>
  8. <m>?-returnNodeCmd?</m> <m>?-tagName name?</m> <m>?-jsonType jsonType?</m> <m>?-namespace URI?</m> <m>(element|comment|text|cdata|pi)Node</m> <m>commandName</m></command>
  9. <desc>This method creates Tcl commands, which in turn create
  10. tDOM nodes. Tcl commands created by this command are only
  11. - avaliable inside a script given to the domNode methods
  12. + available inside a script given to the domNode methods
  13. <m>appendFromScript</m> or <m>insertBeforeFromScript</m>. If
  14. a command created with <m>createNodeCmd</m> is invoked in
  15. any other context, it will return error. The created command
  16. <m>commandName</m> replaces any existing command or
  17. procedure with that name. If the <m>commandName</m> includes
  18.  
  19. Index: doc/domDoc.xml
  20. ==================================================================
  21. --- doc/domDoc.xml
  22. +++ doc/domDoc.xml
  23. @@ -151,13 +151,13 @@
  24. </commanddef>
  25.  
  26. <commanddef>
  27. <command><method>asHTML</method> <option>?-channel
  28. channelId?</option> <option>?-escapeNonASCII?</option> <option>?-htmlEntities?</option> <option>?-doctypeDeclaration &lt;boolean&gt;?</option></command>
  29. - <desc>Returns the DOM tree serialized acording to HTML rules
  30. + <desc>Returns the DOM tree serialized according to HTML rules
  31. (HTML elements are recognized regardless of case, without end
  32. - tags for emtpy HTML elements etc.) as string or sends the
  33. + tags for empty HTML elements etc.) as string or sends the
  34. output directly to the given channelId. If the option
  35. <m>-escapeNonASCII</m> is given, every non 7 bit ASCII
  36. character in attribute values or element PCDATA content will
  37. be escaped as character reference in decimal representation.
  38. If the option <m>-htmlEntities</m> is given, a character is
  39. @@ -167,11 +167,11 @@
  40. the document. The default is, to do not. The DOCTYPE name will
  41. always be the element name of the document element without
  42. case normalization. An external entity declaration of the
  43. external subset is only emitted, if the document has a system
  44. identifier. The doctype declaration will be written from the
  45. - avaliable information, without check, if this is a known
  46. + available information, without check, if this is a known
  47. (w3c) HTML version information or if the document confirms to
  48. the given HTML version.</desc>
  49. </commanddef>
  50.  
  51. <commanddef>
  52. @@ -279,17 +279,17 @@
  53. <desc>Returns the internal subset of the doctype declaration of the
  54. document, if there is one, otherwise the empty string. If there is a value
  55. given to the method, the internal subset of the document is set to this
  56. value. Note that none of the parsing methods preserve the internal subset
  57. of a document; a freshly parsed document will always have an empty internal
  58. -subset. Also note, that the method doesen't do any syntactical check on a
  59. +subset. Also note, that the method doesn't do any syntactical check on a
  60. given internal subset.</desc>
  61. </commanddef>
  62.  
  63. <commanddef>
  64. <command><method>cdataSectionElements</method> <m>(?URI:?localname|*) ?&lt;boolean&gt;?</m></command>
  65. - <desc>This method allows to control for which element nodes
  66. + <desc>This method allows one to control for which element nodes
  67. the text node children will be serialized as CDATA sections (this affects only
  68. serialization with the asXML method, no text node is altered in any
  69. way by this method). IF the method is called with an element name as
  70. first argument and a boolean with value true as second argument, every
  71. text node child of every element node in the document with the same
  72. @@ -309,11 +309,11 @@
  73. serialized as CDATA section nodes.</desc>
  74. </commanddef>
  75.  
  76. <commanddef>
  77. <command><method>selectNodesNamespaces</method> <option>?prefixUriList?</option></command>
  78. - <desc>This method allows to control a document global prefix
  79. + <desc>This method allows one to control a document global prefix
  80. to namespace URI mapping, which will be used for selectNodes
  81. method calls (on document as well as on all nodes, which
  82. belongs to the document) if it is not overwritten by using
  83. the -namespaces option of the selectNodes method. Any
  84. namespace prefix within an xpath expression will be first
  85. @@ -370,11 +370,11 @@
  86. <commanddef>
  87. <command><method>toXSLTcmd</method> ?<m>objVar</m>?</command>
  88.  
  89. <desc>If the DOM tree represents a valid XSLT stylesheet, this method
  90. transforms the DOM tree into an xslt command, otherwise it returns error. The
  91. -created xsltCmd is returnd and stored in the <m>objVar</m>, if a var name was
  92. +created xsltCmd is returned and stored in the <m>objVar</m>, if a var name was
  93. given. A successful transformation of the DOM tree to an xsltCmd removes the
  94. domDoc cmd and all nodeCmds of the document.
  95.  
  96. <p>The syntax of the created xsltCmd is:</p>
  97.  
  98. @@ -451,11 +451,11 @@
  99. </commanddef>
  100.  
  101. <commanddef>
  102. <command><method>getElementById</method> <m>id</m></command>
  103. <desc>Returns the node having a id attribute with value
  104. -<m>id</m> or the emtpy string, if no node has an id attribute with that value.</desc>
  105. +<m>id</m> or the empty string, if no node has an id attribute with that value.</desc>
  106. </commanddef>
  107.  
  108. <commanddef>
  109. <command><method>firstChild</method> <variable>?objVar?</variable></command>
  110. <desc>Returns the first top level node of the document.</desc>
  111. @@ -623,11 +623,11 @@
  112. <p>Otherwise, if an unknown method name is given, the command with the
  113. same name as the given method within the namespace <samp>::dom::domDoc</samp> is
  114. tried to be executed. This allows quick method additions on Tcl level.</p>
  115.  
  116. <p>Newly created nodes are appended to a hidden fragment list. If they
  117. -are not moved into the tree they are automaticaly deleted as soon as the whole
  118. +are not moved into the tree they are automatically deleted as soon as the whole
  119. document gets deleted.</p>
  120.  
  121. </section>
  122.  
  123. <seealso>
  124.  
  125. Index: doc/domNode.xml
  126. ==================================================================
  127. --- doc/domNode.xml
  128. +++ doc/domNode.xml
  129. @@ -129,11 +129,11 @@
  130. </commanddef>
  131.  
  132. <commanddef>
  133. <command><method>getElementById</method> <m>id</m></command>
  134. <desc>Returns the node having an id attribute with value
  135. -<m>id</m> or the emtpy string if no node has an id attribute with that value.</desc>
  136. +<m>id</m> or the empty string if no node has an id attribute with that value.</desc>
  137. </commanddef>
  138.  
  139. <commanddef>
  140. <command><method>hasAttribute</method> <m>attributeName</m></command>
  141. <desc>Returns 1 if the object node contains an attribute with name
  142. @@ -195,11 +195,11 @@
  143. method has the same effect as the method <b>setAttribute</b>.</p>
  144.  
  145. <example>$node setAttributeNS "" attri "some Value"</example>
  146.  
  147. <p>With the exceptions of the special prefixes "xmlns" and "xml" you
  148. -always must provide a non emtpy <m>uri</m>, if your <m>qualifiedName</m> has a
  149. +always must provide a non empty <m>uri</m>, if your <m>qualifiedName</m> has a
  150. prefix. It is not recommended to set xml namespace declarations. The effects are complicated and not always obvious up to resulting a not well-formed serializations after further processing.</p></desc>
  151. </commanddef>
  152.  
  153. <commanddef>
  154. <command><method>removeAttributeNS</method> <m>uri</m> <m>localName</m></command>
  155. @@ -360,11 +360,11 @@
  156. <p>Similar to the way described above to inject literals in a secure
  157. way into the XPath expression using tcl variable references there is a
  158. syntax to inject element names from tcl variables. At every place
  159. where the XPath syntax allows a node test there could be a tcl
  160. variable reference (in any form), just the leading $ replaced with %.
  161. -This allows to select nodes with 'strange' (invalid, according to the
  162. +This allows one to select nodes with 'strange' (invalid, according to the
  163. appropriate XML production rule) node names which may be needed in
  164. case of working with JSON data.</p>
  165.  
  166. <p>The option <m>-namespaces</m> expects a tcl list with prefix /
  167. namespace pairs as argument. If this option is not given, then any
  168. @@ -412,17 +412,17 @@
  169. </desc>
  170. </commanddef>
  171.  
  172. <commanddef>
  173. <command><method>getLine</method></command>
  174. - <desc>Returns the line number of that node in the orignal parsed
  175. + <desc>Returns the line number of that node in the originally parsed
  176. XML.</desc>
  177. </commanddef>
  178.  
  179. <commanddef>
  180. <command><method>getColumn</method></command>
  181. - <desc>Returns the column number of that node in the orignal parsed
  182. + <desc>Returns the column number of that node in the originally parsed
  183. XML.</desc>
  184. </commanddef>
  185.  
  186. <commanddef>
  187. <command><method>asList</method></command>
  188. @@ -467,12 +467,12 @@
  189.  
  190. <commanddef>
  191. <command><method>asHTML</method> <option>?-channel channelId?</option>
  192. <option>?-escapeNonASCII?</option> <option>?-htmlEntities?</option></command>
  193. <desc>Returns the DOM substree starting from the current node as the
  194. -root node of the result serialized acording to HTML rules (HTML elements are
  195. -recognized regardless of case, without end tags for emtpy HTML elements etc.),
  196. +root node of the result serialized according to HTML rules (HTML elements are
  197. +recognized regardless of case, without end tags for empty HTML elements etc.),
  198. as string or sends the output directly to the given channelId. If the option
  199. <m>-escapeNonASCII</m> is given, every non 7 bit ASCII character in attribute
  200. values or element PCDATA content will be escaped as character reference in
  201. decimal representation. If the option <m>-htmlEntities</m> is given, a
  202. character is written using its HTML 4.01 character entity reference, if one is
  203. @@ -526,11 +526,11 @@
  204. <commanddef>
  205. <command><method>toXPath</method> <m>?-legacy?</m></command>
  206. <desc>Returns an XPath, which exactly addresses the given
  207. node in its document. This XPath is only valid as there are no changes to DOM
  208. tree made later one. With the -legacy option, other XPath expressions
  209. -are returnd, which doesn't work in all cases.</desc>
  210. +are returned, which doesn't work in all cases.</desc>
  211. </commanddef>
  212.  
  213. <commanddef>
  214. <command><method>getBaseURI</method></command>
  215. <desc>Returns the baseURI of the node. This method is deprecated in
  216. @@ -539,11 +539,11 @@
  217.  
  218. <commanddef>
  219. <command><method>baseURI</method> <m>?URI?</m></command>
  220. <desc>Returns the present baseURI of the node. If the optional
  221. argument URI is given, it sets the base URI of the node and of all of its child
  222. -nodes out of the same enitity as node to the given URI.</desc>
  223. +nodes out of the same entity as node to the given URI.</desc>
  224. </commanddef>
  225.  
  226. <commanddef>
  227. <command><method>disableOutputEscaping</method> <m>?boolean?</m></command>
  228. <desc>This method works only for text nodes; for every other node it
  229. @@ -550,11 +550,11 @@
  230. returns error. Without the optional argument it returns, if disabling output
  231. escaping is on. The return value 0 means, the characters of the text node will
  232. be escaped, to generate valid XML, if serialized. This is the default for
  233. every parsed or created text node (with the exception of that text nodes in a
  234. result tree of an XSLT transformation, for which disabling output escaping was
  235. -requested explicitely in the stylesheet). The return value 1 means, that output
  236. +requested explicitly in the stylesheet). The return value 1 means, that output
  237. escaping is disabled for this text node. If such a text node is serialized
  238. (with asXML or asHTML), it is literally written, without escaping of the
  239. special XML characters. If the optional boolean value <m>boolean</m> is given,
  240. the flag is set accordingly. You should not set this flag to 1 until you
  241. really know what you do.</desc>
  242. @@ -608,11 +608,11 @@
  243.  
  244. <p>The <m>-xsltmessagecmd</m> option sets a callback for xslt:message elements
  245. in the stylesheet. The actual command consists of the script, given as argument
  246. to the option, appended with the XML Fragment from instantiating the
  247. xsl:message element content as string (as if the XPath string() function would
  248. -have been applied to the XML Fragment) and a flag, which indicates wether the
  249. +have been applied to the XML Fragment) and a flag, which indicates whether the
  250. xsl:message has an attribute "terminate" with the value "yes". If the
  251. called script returns anything else then TCL_OK then the xslt
  252. transformation will be aborted, returning error. If the called script
  253. returns -code break the error message is empty, otherwise the result
  254. code is reported. In case of terminated transformation the outputVar,
  255.  
  256. Index: doc/expat.xml
  257. ==================================================================
  258. --- doc/expat.xml
  259. +++ doc/expat.xml
  260. @@ -555,11 +555,11 @@
  261. <desc>If &lt;boolen&gt; is true and the document does not have an
  262. external subset, the parser will call the -externalentitycommand script with
  263. empty values for the systemId and publicID arguments. This option must be set,
  264. before the first piece of data is parsed. Setting this option, after the
  265. parsing has started has no effect. The default is not to use a foreign DTD. The
  266. -default is restored, after reseting the parser. Pleace notice, that a
  267. +default is restored, after resetting the parser. Pleace notice, that a
  268. -paramentityparsing value of "never" (which is the default) suppresses any call
  269. to the -externalentitycommand script. Pleace notice, that, if the document also
  270. doesn't have an internal subset, the -startdoctypedeclcommand and
  271. enddoctypedeclcommand scripts, if set, are not called.</desc>
  272. </optdef>
  273. @@ -693,11 +693,11 @@
  274.  
  275. <commanddef>
  276. <command><cmd>parser</cmd> <method>reset</method></command>
  277.  
  278. <desc><p>Resets the parser in preparation for parsing another
  279. -document. A parser cannot be reseted from within one of its handler callbacks
  280. +document. A parser cannot be reset from within one of its handler callbacks
  281. (neither directly nor indirectly) and will raise a tcl error in this
  282. cases.</p></desc>
  283. </commanddef>
  284. </commandlist>
  285. </section>
  286.  
  287. Index: doc/expatapi.xml
  288. ==================================================================
  289. --- doc/expatapi.xml
  290. +++ doc/expatapi.xml
  291. @@ -67,11 +67,11 @@
  292. </arglist>
  293. </section>
  294.  
  295. <section>
  296. <title>DESCRIPTION</title>
  297. -<p>The functions described in this manual allows to add C level coded event
  298. +<p>The functions described in this manual allows one to add C level coded event
  299. handler to an tDOM Tcl expat parser objects. A tDOM Tcl expat parser object is
  300. able to have several Tcl scripts and C functions associated with an specific
  301. event. If the event occurs, first the Tcl scripts then the C functions
  302. associated with the event are called in turn.</p>
  303.  
  304. @@ -86,11 +86,11 @@
  305. struct CHandlerSet *nextHandlerSet;
  306. char *name; /* refname of the handler set */
  307. int ignoreWhiteCDATAs; /* ignore 'white' CDATA sections */
  308.  
  309. void *userData; /* Handler set specific Data Structure;
  310. - the C handler set extention has to
  311. + the C handler set extension has to
  312. malloc the needed structure in his
  313. init func and has to provide a
  314. cleanup func (to free it). */
  315.  
  316. CHandlerSet_userDataReset resetProc;
  317. @@ -158,11 +158,11 @@
  318.  
  319. <p><m>resetProc</m> and <m>freeProc</m> must have arguments that match the
  320. type</p>
  321. <syntax>void (Tcl_Interp *interp, void *userData)</syntax>
  322.  
  323. - <p><m>resetProc</m> is called in case the parser is reseted with
  324. + <p><m>resetProc</m> is called in case the parser is reset with
  325. <samp>&lt;parserObj&gt; reset</samp> and should do any necessary cleanup and
  326. reinitializing to prepare the C handler set for a new XML document. The
  327. <m>freeProc</m> is called, if the parser is deleted and should do memory
  328. cleanup etc. </p>
  329.  
  330.  
  331. Index: doc/tnc.xml
  332. ==================================================================
  333. --- doc/tnc.xml
  334. +++ doc/tnc.xml
  335. @@ -40,18 +40,18 @@
  336. </commanddef>
  337.  
  338. <commanddef>
  339. <command><cmd>tnc</cmd> <m>parserObj</m> <method>getValidateCmd</method> <option>?validateCmdName?</option></command>
  340.  
  341. - <desc><p>Returns a new created validation command, if one is avaliable
  342. + <desc><p>Returns a new created validation command, if one is available
  343. from the parser command, otherwise it signals error. The name of the validation
  344. command is the <m>validateCmdName</m>, if this optional argument was given, or
  345. -a random choosen name. A validation command is avaliable in a parser command,
  346. +a random chosen name. A validation command is available in a parser command,
  347. if the parser with tnc enabled was previously used, to parse an XML document
  348. with a valid doctype declaration, a valid external subset, if one was given by
  349. the doctype declaration, and a valid internal subset. The further document
  350. -doesn't need to be valid, to make the validation command avaliable. The
  351. +doesn't need to be valid, to make the validation command available. The
  352. validation command can only get received one time from the parser command. The
  353. created validation command has this syntax:</p>
  354.  
  355. <syntax><cmd>validationCmd</cmd> <m>method</m> <m>?args?</m></syntax>
  356.  
  357. @@ -69,12 +69,12 @@
  358.  
  359. <commanddef>
  360. <command><method>validateTree</method> <m>elementNode</m> <m>?varName?</m></command>
  361.  
  362. <desc>Checks, if the given subtree with <m>domNode</m> as root element
  363. -is a posible valid subtree of a document conforming to the DTD information
  364. -represented by teh validation command. IDREF could not checked, while
  365. +is a possible valid subtree of a document conforming to the DTD information
  366. +represented by the validation command. IDREF could not checked, while
  367. validating only a subtree, but it is checked, that every known ID attribute in
  368. the subtree is unique. Returns 1, if the subtree is OK, 0 otherwise. If the
  369. <m>varName</m> argument is given, then the variable it names is set to the
  370. detected reason for the validation error or to the empty string in case of
  371. a valid subtree.</desc>