~valavanisalex/ubuntu/precise/inkscape/fix-943984

« back to all changes in this revision

Viewing changes to inkscape-0.47pre1/packaging/win32/AdvUninstLog.txt

  • Committer: Bazaar Package Importer
  • Author(s): Bryce Harrington
  • Date: 2009-07-02 17:09:45 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20090702170945-nn6d6zswovbwju1t
Tags: 0.47~pre1-0ubuntu1
* New upstream release.
  - Don't constrain maximization on small resolution devices (pre0)
    (LP: #348842)
  - Fixes segfault on startup (pre0)
    (LP: #391149)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Overview
 
2
 
 
3
Advanced Uninstall Log for NSIS was born in the need to cover a specific gap.
 
4
It's been discussed fairly enough that the File /r command is very useful
 
5
in cases when developers want to add a huge amount of sub directories and
 
6
files, nevertheless it has the disadvantage that such an installation should
 
7
be uninstalled with RmDir /r which is risky and removes also data that has
 
8
been added/created later within the installation folder.
 
9
 
 
10
 
 
11
 
 
12
 
 
13
About Advanced Uninstall Log.
 
14
 
 
15
Advanced Uninstall Log is a macro system provided in a NSIS header that
 
16
is able to monitor an installation and build an uninstall log file which
 
17
is used by the uninstaller to uninstall files/directories that have been
 
18
added within specific installation blocks.
 
19
 
 
20
This means that files which have been installed outside these blocks,
 
21
or added later either by the user or application's activities, ignored
 
22
by the uninstaller.
 
23
 
 
24
Moreover files that might exist into the target directory prior the current
 
25
installation, ignored as well.
 
26
 
 
27
Advanced Uninstall Log creates an uninstall log that removes only files that
 
28
have been installed and optionally interacts with users for every other file
 
29
and/or directory has found in installation folder and requires permission to
 
30
remove these files/directories.
 
31
 
 
32
It is enhanced as well to support updates, e.g. if the installer later would
 
33
update the installation by adding new data, the uninstaller would remove the
 
34
new data that has been added by the installer, without bothering users about.
 
35
 
 
36
 
 
37
 
 
38
 
 
39
Features
 
40
 
 
41
If target installation folder exists and contains files and/or directories
 
42
they all preserved from being uninstalled.
 
43
 
 
44
Uninstaller removes data that has been added within specific installation
 
45
blocks, preserving all other data that has been created/added outside of
 
46
these installation blocks. See included examples for details.
 
47
 
 
48
Supports unlimited updates/reinstallations.
 
49
 
 
50
Supports two uninstaller modes. Interactive mode requires confirmation
 
51
to remove every other file exept those files that have been installed.
 
52
Unattended mode leaves intact every other file without bothering users.
 
53
 
 
54
In case when uninstall log (uninstall.dat) has been removed manually instead
 
55
of execute uninstaller, if users attempt to run the installer later, a warning
 
56
issued that they should select a new output folder.
 
57
 
 
58
Implements only the included with NSIS release headers FileFunc and TextFunc.
 
59
There is no need for external plugins and headers, adds a very small overhead.
 
60
 
 
61
 
 
62
 
 
63
 
 
64
Restrictions
 
65
 
 
66
If uninstall log (uninstall.dat) is missing uninstaller won't execute at all.
 
67
 
 
68
Due to file create - write procedure that is required in order to add/update
 
69
the uninstall log (uninstall.dat), restricted users on NT based systems won't 
 
70
be able to execute the installer.
 
71
 
 
72
 
 
73
 
 
74
 
 
75
Disadvantage
 
76
 
 
77
Since the header does not implement anything else than the common NSIS release,
 
78
a delay occurs while builds and reads the uninstall log because it needs to
 
79
throw the list several times. Talking for common cases, most likely the delay
 
80
won't be noticeable, however, in cases where the target directory isn't empty
 
81
and contains a large amount of data which will be excluded from uninstall log,
 
82
or added large amount of data after the installation which will be excluded also,
 
83
the delay should be noticeable.
 
84
 
 
85
 
 
86
 
 
87
 
 
88
Credits
 
89
 
 
90
A very big thanks goes to kichik.
 
91
When my idea of the Advanced Uninstall Log became an NSIS header, it was 
 
92
indeed an amateur's attempt to write a flexible and errors free NSIS header.
 
93
Kichik dropped me a dozen of suggestions helping me to achieve my plan.
 
94
However, his main suggestion to eliminate the mentioned above disadvantage,
 
95
still remains untouched by me.
 
96
 
 
97
 
 
98
 
 
99
 
 
100
License
 
101
 
 
102
This header file is provided 'as-is', without any express or implied warranty.
 
103
In no event will the author be held liable for any damages arising from the use
 
104
of this header file.
 
105
 
 
106
Permission is granted to anyone to use this header file for any purpose,
 
107
including commercial applications, and to alter it and redistribute it freely,
 
108
subject to the following restrictions:
 
109
 
 
110
   1. The origin of this header file must not be misrepresented; 
 
111
      you must not claim that you wrote the original header file.
 
112
      If you use this header file in a product, an acknowledgment in 
 
113
      the product documentation would be appreciated but is not required.
 
114
 
 
115
   2. Altered versions must be plainly marked as such, and must not be 
 
116
      misrepresented as being the original header file.
 
117
 
 
118
   3. This notice may not be removed or altered from any distribution. 
 
119
 
 
120
 
 
121
eof
 
 
b'\\ No newline at end of file'