Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Unified Diff: update-copyright/README.md

Issue 29459580: Issue 5250 - Add copyright update script (Closed) Base URL: https://hg.adblockplus.org/codingtools
Patch Set: Clean up comments, ReadMe, formatting Created July 4, 2017, 1:38 p.m.
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: update-copyright/README.md
===================================================================
new file mode 100644
--- /dev/null
+++ b/update-copyright/README.md
@@ -0,0 +1,21 @@
+# update-copyright #
Vasily Kuznetsov 2017/07/04 15:02:40 In general we don't add # at ends of headings in t
rosie 2017/07/04 15:14:02 Done.
+
+This script accepts a URL to a mercurial index as input. It then makes a local copy of each repo, updates the copyright information on every file to the current year, then attempts to push the updates. If a user doesn't have permission to push to a repo, the script will make a local `repo-name.patch` file to submit later. You are free to use it for other projects but please keep in mind that we make no stability guarantees whatsoever and might change functionality any time.
Vasily Kuznetsov 2017/07/04 15:02:40 Another mostly consistency-related point: the long
rosie 2017/07/04 15:14:02 Done.
+
+## How to use ##
+
+To update the copyright on all the repos indexed at [https://hg.adblockplus.org/](https://hg.adblockplus.org/), you can use the accompanying shell script, e.g.:
+
+ ./run_update_copyright.sh
+
+To run the script elsewhere, you must specify the URL for a Mercurial index site to scrape, e.g.:
+
+ python3 update_copyright.py -u https://hg.example.com/
+
+You may also specify a base URL of a remote repo to push to, if it is different than the base URL of the index page, e.g.:
+
+ python3 update_copyright.py -u https://hg.example.com/ -p ssh://user@hg.example.com/
+
+## Testing ##
+
+Testing can be run via [tox](http://tox.readthedocs.org/).

Powered by Google App Engine
This is Rietveld