Side by Side Diff: installer/src/documentation/source_code.dox
Issue 5394579117309952:
Installer localization and new build system (Closed)
Patch Set:
Created Dec. 10, 2013, 4:11 a.m.
| Left: | ||
| Right: |
Use n/p to move between diff chunks;
N/P to move between comments.
« no previous file with comments
|
« installer/src/documentation/mainpage.dox ('k')
|
installer/src/msi/locale/ar.wxl » ('j')
|
no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')
| OLD | NEW |
|---|---|
| (Empty) | |
| 1 /*! | |
| 2 | |
| 3 \page source_code Source Code | |
| 4 | |
| 5 ## Localization Source ## | |
| 6 | |
| 7 See \subpage localization for all the relevant MSI data structures. | |
| 8 | |
| 9 \par WiX `.loc` localization files | |
| 10 | |
| 11 - WiX | |
| 12 [WixLocalization Element] (http://wixtoolset.org/documentation/manual/v3/xsd/w ixloc/wixlocalization.html) | |
| 13 | |
| 14 \par WiX sources for SIS strings | |
| 15 | |
| 16 The WiX documentation isn't always very explicit about how it maps WiX elements and attributes to MSI values. | |
| 17 Most of them are in the WiX elements `Product` and `Package`. | |
| 18 The documentation for `Package` elements states that it is "properties about the package to be placed in the Summary Information Stream." | |
| 19 That, however, is misleading, since it's not the only source of such properties. | |
| 20 nor does quite every attribute in the element appear in the SIS. | |
| 21 | |
| 22 - MSDN | |
| 23 [Summary Property Descriptions] (http://msdn.microsoft.com/en-us/library/windo ws/desktop/aa372049%28v=vs.85%29.aspx) | |
| 24 - WiX | |
| 25 [Product Element] (http://wixtoolset.org/documentation/manual/v3/xsd/wix/produ ct.html) | |
| 26 - WiX | |
| 27 [Package Element] (http://wixtoolset.org/documentation/manual/v3/xsd/wix/packa ge.html) | |
| 28 | |
| 29 This section enumerates the properties in the SIS and shows where they originate in the source code. | |
| 30 They are listed in order of their property index numbers, the same order used by the `msiinfo`. | |
| 31 The properties in the SIS appear in the Control Panel tool _Programs and Feature s_. | |
| 32 | |
| 33 - **Codepage**. | |
| 34 In the attribute `Package/@SummaryCodepage`. | |
| 35 This is the code page used to display strings in the Summary Information. | |
| 36 - **Title**. | |
| 37 The fixed string "Installation Database". | |
| 38 - **Subject**. | |
| 39 In the attribute `Package/@Description`. | |
| 40 Appears as the "Name" field in the tabular listing in Programs and Features. | |
| 41 - **Author**. | |
| 42 In the attribute `Package/@Manufacturer`. | |
| 43 If omitted, (apparently) defaults to `Product/@Manufacturer`. | |
| 44 Appears as the "Publisher" field in the tabular listing in Programs and Featur es. | |
| 45 Related to this, there's a property "Manufacturer" in the installer database. | |
| 46 - **Keywords**. | |
| 47 In the attribute `Package/@Keywords`. | |
| 48 Appears at the bottom of Programs and Features when the package is selected. ( ?) | |
| 49 - **Comments**. | |
| 50 In the attribute `Package/@Comments`. | |
| 51 Appears at the bottom of Programs and Features when the package is selected. | |
| 52 - **Template**. | |
| 53 This single SIS property is the concatenation of two fields. | |
| 54 The first is the value of the `-arch` command line option of the compiler `can dle`. | |
| 55 If that's not specified, it's in `Package/@Platform` or `Package/@Platforms`. | |
| 56 The second is in `Package/@Languages`. | |
| 57 - **Revision**. | |
| 58 Used to store the package GUID | |
| 59 In attribute `Package/@Id`, but is automatically generated if absent, | |
| 60 which is the recommended usage. | |
| 61 - **Last Printed**. | |
| 62 Used for administrative images. | |
| 63 Not a concern for us, but set by a tool. | |
| 64 - **Create Time/Date**. | |
| 65 The linker sets this value. | |
| 66 So does the embedding tool, which is arguably a defect in the Automation inter face. | |
| 67 - **Last Saved Time/Date**. | |
| 68 The linker sets this value, as do the other tools that modify the MSI. | |
| 69 - **Page Count**. | |
| 70 Used to store the minimum installer version required to install. | |
| 71 In the attribute `Package/@InstallerVersion`. | |
| 72 - **Word Count**. | |
| 73 A bit field in attributes `Package/@ShortNames`, `Package/@Compressed`, `Packa ge/@AdminImage`, and `Package/@InstallPrivileges`. | |
| 74 - **Creating Application**. | |
| 75 Set by the linker to "Windows Installer XML" and a version number. | |
| 76 - **Security**. | |
| 77 A bit field in attribute `Package/@ReadOnly`. | |
| 78 | |
| 79 \par Localization of the WiX UI extension. | |
| 80 | |
| 81 We are using the WiX UI extension for the installer. | |
| 82 It already has localizations for many languages, | |
| 83 including most of the ones that we already support in the plugin. | |
| 84 There are a few, however, that do not have localizations, yet, and we'll have to provide them. | |
| 85 The source code location for these WiX localizations is `src/ext/UIExtension/wix lib` | |
| 86 with files named `WixUI_<language-code>.wxl`. | |
| 87 These lists were checked against both WiX 3.7 and WiX 3.8. | |
| 88 | |
| 89 The WiX UI extension DOES NOT support the following languages that we do. | |
| 90 | |
| 91 - fil-PH. Filipino - Phillipines. | |
| 92 - kn-IN. Kanada - India. | |
| 93 - mr-IN. Maratha - India. | |
| 94 - ms. Malaysian - generic. | |
| 95 - nn-NO. Nynorsk - Norway. | |
| 96 - ur-PK. Urdu - Pakistan. | |
| 97 | |
| 98 The WiX UI extension supports the following languages that we do not yet support . | |
| 99 | |
| 100 - kk-KZ. Kazakh - Kazakhstan. | |
| 101 - ko-KR. Korean - Korea. | |
| 102 - lt-LT. Lithuanian - Lithuania. | |
| 103 - lv-LV. Latvian - Latvia. | |
| 104 - sl-SI. Slovenian - Slovenia. | |
| 105 - sr-Latn-CS. Serbian, Latin alphabet - Serbia and Montenegro. | |
| 106 - zh-HK. China - Hong Kong | |
| 107 | |
| 108 */ | |
| OLD | NEW |
« no previous file with comments
|
« installer/src/documentation/mainpage.dox ('k')
|
installer/src/msi/locale/ar.wxl » ('j')
|
no next file with comments »
