[Python-checkins] r45839 - python/trunk/Doc/lib/lib.tex python/trunk/Doc/lib/libmsilib.tex

["Martin v. Löwis"]

Jim Jewett wrote:
> Is there an URL describing these formats?

Not to my knowledge: they are both undocumented (MSI probably more
so than CAB, for which third-party tools exist).

>> +\begin{funcdesc}{FCICreate}{cabname, files}
>> +  Create a new CAB file named \var{cabname}. \var{files} must
>> +  be a list of tuples, each containing the name of the file on
>> +  disk, and the name of the file inside the CAB file.
>> +
>> +  The files are added to the CAB file in the order they have
>> +  in the list. All files are added into a single CAB file,
>> +  using the MSZIP compression algorithm.
> 
> Should that be "in the order that they appear in the list"/

If that is better English: sure.

> Is there a good URL for the MSZIP format?
> 
> google pointed at non-MS sources, though one suggested
> http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dncabsdk/html/cabdl.asp

That's only the SDK, though, and it only has API specs;
these are the ones that _msi.c uses.

In any case, I want to replace MSZIP with LZX:21 before
the release (not that this is better documented).

>> +\begin{funcdesc}{OpenDatabase}{path, persist}
>> +  Return a new database object by calling MsiOpenDatabase.
>> +  \var{path} is the file name of the
>> +  MSI file; persist can be one of the constants
>> +  \code{MSIDBOPEN_CREATEDIRECT}, \code{MSIDBOPEN_CREATE},
>> +  \code{MSIDBOPEN_DIRECT}, \code{MSIDBOPEN_READONLY}, or
>> +  \code{MSIDBOPEN_TRANSACT}, and may include the flag
>> +  \code{MSIDBOPEN_PATCHFILE}. See the Microsoft documentation for
>> +  the meaning of these flags; depending on the flags,
>> +  an existing database is opened, or a new one created.
>> +\end{funcdesc}
> 
> Any particular place in the documentation?  Preferably an URL

That's in the see-also section already, for MsiOpenDatabase.

>> +  This is typically used to install the sequence
>> +\end{funcdesc}
> 
> Is that last sentence complete?

Ah, no. It should end with "tables."

Thanks,
Martin