To comment on the following update, log in, then open the issue: http://www.openoffice.org/issues/show_bug.cgi?id=85426 Issue #|85426 Summary|Document path extension properly for XAutoTextContaine |r.insertNewByName() Component|api Version|OOo 2.3.1 Platform|All URL| OS/Version|All Status|UNCONFIRMED Status whiteboard| Keywords| Resolution| Issue type|DEFECT Priority|P3 Subcomponent|documentation Assigned to|jsc Reported by|mux2005
------- Additional comments from [EMAIL PROTECTED] Mon Jan 21 10:15:43 +0000 2008 ------- XAutoTextContainer.insertNewByName() accepts a group name in the form "name" + "*" + pathentrynumber, where pathentrynumber describes where the autotext is to be stored. This is not properly documented. Right now the only trace of documentation is in an Example subsection of XAutoTextContainer, which is, due to spelling and markup mistakes, a pain to look at (and I consequently overlooked it). It's also lacking any kind of context (e.g. what is "AutoTextPath" ?). I'd like the documentation improved in the following ways 1) document the groupname + "*" + number syntax at insertNewByName(). When people use the IDL docs for reference purposes to look for information about the parameter for a function call, they don't look in some Example subsection elsewhere on the page. The doc needs to be together with the function call. 2) Document precisely (or link to the documentation, probably PathSettings#AutoText) how the AutoTextPath that the number component refers to is formed. It is apparently not simply the path found in Tools/Options/Paths/AutoText. In my case that path lists only 1 component, namely my local user directory. However using *0 doesn't work in my basic macro, presumably because the shared location (to which a normal user account doesn't have write access) is implicitly added in the front of the path. Related to this: the documentation to PathSettings#AutoText could be improved to state that this is not identical to what you can configure in Tools/Options/Paths, because PathSettings#AutoText contains the shared section as 1st element, which is not visible in Tools/Options/Paths. The documentation of PathSettings#AutoText should state, where this path is taken from. 3) Document the recommended way for a program to determine the proper "*" number value. At the moment, apart from analysing PathSettings#AutoText to find a directory that the user has write access to, I don't see how I'm supposed to determine the correct number. Is this the only way? Related: Please state clearly that leaving the * number out will usually NOT work portably. It's likely to work under Windows (where users commonly have administrator rights), but on Unix machines the shared location (implict first element of path, used in absence of * number) is not writable by users. So when one wants to use insertNewByName reliably, one MUST provide a * number with number > 0. 4) Fix the markup issues in the example subsection and present working Basic example code or at least give some context. --------------------------------------------------------------------- Please do not reply to this automatically generated notification from Issue Tracker. Please log onto the website and enter your comments. http://qa.openoffice.org/issue_handling/project_issues.html#notification --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
