fanboy-adblock/docs/hg-howto.txt
2016-04-16 06:08:13 +02:00

80 lines
2.5 KiB
Plaintext

Tools required
--------------
Activeperl (http://www.activestate.com/activeperl/)
Mercurial (http://mercurial.selenic.com)
Text Editor (http://www.pspad.com or http://notepad-plus-plus.org/)
Installation of Tools
---------------------
1) Install Activeperl
2) Install Mercurial, all defaults during install active
3) Install your chosen Text editor
Setting up Googlecode Login
---------------------------
4) Open the command prompt,
4a) cd %USERPROFILE%
4b) hg clone https://fanboy-adblock-list.googlecode.com/hg/ fanboy-adblock-list
4c) cd fanboy-adblock-list
4d) cd .hg
4e) edit the file "hgrc" using your chosen text editor, include the following infomation in the hgrc file.
[paths]
default = https://fanboy-adblock-list.googlecode.com/hg/
username = your name <gmail-username@gmail.com>
default-push = https://username:password@fanboy-adblock-list.googlecode.com/hg/
[ui]
username = gmail-username@gmail.com
verbose = true
[extensions]
rebase =
fetch =
b = C:\Users\Username\fanboy-adblock-list\scripts\b.py
(Note, use the googlecode password not the gmail password)
Login to google/gmail first, then visit http://code.google.com/p/fanboy-adblock-list/source/list
Get your password through the google profile menu, top right, profile then settings. *Password is case sensitive.*
Use this password in the "default-push" in 4e example above.
4f) Save changes, and now we're ready to make changes. Be sure you're in the main dir of "fanboy-adblock-list", when you want to start making changes.
Making Additions
----------------
adding new filters --> add-filter.bat <URL>
1) Make the change to the list(s), Save.
2) Copy Website, Copy Adblock infomation, and username. Save.
3) Done, its committed.
adding new elements -->
1) Make the change to the list(s), Save files.
2) add-element.bat <URL>
3) Done, its committed.
False Positives
---------------
adding new filters --> add-filter.bat fp: <URL>
1) Make the change to the list(s), Save.
2) Copy Website, Copy Adblock infomation, and username. Save.
3) Done, its committed.
Syncing new changes
-------------------
To sync any newer changes, you can just issue the following command,
hgsync.bat
Merging
-------
Occasionally if 2 people (or more) are working the same file at the same time.. you'll get a merge error/request.
Follow the docs\Windows_merge_notes.pdf this will help. You will need grep for Windows (http://gnuwin32.sourceforge.net/packages/grep.htm).
examples of additions comments:
http://code.google.com/p/fanboy-adblock-list/source/list