Source code
Revision control
Copy as Markdown
Other Tools
This directory contains the liteFirewall plugin for the Windows NSIS↩
installer. This enables creation of firewall rules during the↩
install process.↩
↩
This directory contains an modified copy of the liteFirewall source code↩
version 1.0, which is based on nsisFirewall 1.2. As stated by License.txt↩
this code is under the zlib license. A few modifications have been made↩
to this copy of the source code. The recent modifications among those↩
are contained in mozilla_customizations.diff, which should be↩
found in the same directory as this file.↩
↩
Making Future src Customizations↩
--------------------------------↩
↩
When we make future customizations, they should be made both to the source↩
files, and to `mozilla_customizations.diff`. Ideally, this should be done in a↩
consistent way so that the changes to `mozilla_customizations.diff` are at↩
least somewhat readable in code review rather than just being a complete↩
rewrite of the file every time. Following these steps should accomplish this.↩
↩
1) Start with a clean copy of mozilla-central.↩
2) Make a Mercurial commit: `hg commit`. For convenience referring to this↩
commit later, you can bookmark it: `hg bookmark -if liteFirewall`.↩
3) Update back to central: `hg up central`.↩
4) Generate a diff and ensure there are no new changes to `mozilla_customizations.diff`:↩
`hg diff --from=central --to=liteFirewall --unified=3 | diff - other-licenses/nsis/Contrib/liteFirewall/mozilla_customizations.diff`↩
If there are any changes (say `hg diff`'s output format changed), it may be↩
good to re-generate `mozilla_customizations.diff` and commit it separately.↩
5) Make the new customizations.↩
6) Build the Visual Studio solution.↩
This may be incompatible with later versions of Visual Studio. We can↩
get around this by upgrading the solution file when prompted, however,↩
these updated project files should not be committed.↩
This may require that the Visual Studio Installer be re-run to add the↩
MFC components, if you don't already have it. This can be done by following↩
the instructions on [Microsoft Learn](https://learn.microsoft.com/en-us/visualstudio/msbuild/errors/msb8041).↩
Ensure the build targets point to other-licenses/nsis/Plugins.liteFirewallW.dll↩
and that the build is done for Unicode.↩
7) Regenerate `mozilla_customizations.diff` while only capturing the file extensions needed:↩
`hg diff --from=central --to=liteFirewall --unified=3 -I "**/*.h" -I "**/*.cpp" -I "other-licenses/nsis/Contrib/liteFirewall/" >> other-licenses/nsis/Contrib/liteFirewall/mozilla_customizations.diff`↩