File: README

package info (click to toggle)
perspectives-extension 4.5.2-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 888 kB
  • ctags: 227
  • sloc: python: 175; makefile: 44
file content (56 lines) | stat: -rw-r--r-- 1,757 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
Perspectives - Connect securely to https websites by checking certificates with network notaries.


This directory includes the code for the Perspectives Firefox and Seamonkey clients.

For more information see: http://www.perspectives-project.org


CONTACT

You can contact the developers on the Perspectives Dev newsgroup:

https://groups.google.com/group/perspectives-dev
perspectives-dev@googlegroups.com


HACKING

Requirements:
- a POSIX command line environment
- make
- zip

Optional (but strongly recommended!):
- python and the python 'lxml' library (to run the build tests)


To build, just type "make" (assuming of course you have make installed!). This will create a file called 'Perspectives.xpi'.  

You can run Perspectives in Firefox using File -> Open and browsing to the Perspectives.xpi file.

To debug the extension:

* Edit the d_print_flags in plugin/chrome/content/common.js
* Rebuild using make
* Reload the extension and restart your browser
* Use the Firefox extension 'Firebug' to view what's happening as Perspectives runs

Feel free to try Venkman or other debug methods (cf. https://developer.mozilla.org/en/Setting_up_extension_development_environment )


TESTING

To test Perspectives:

- Use 'make test' to build and install the Perspectives extension, as above
- Open chrome://perspectives/content/test/test.html in your browser
- Press the 'Run Tests' button

Test results will be displayed on the page.


Some tests are performed at build time - e.g. checking the localization files for the correct format and contents. All tests of the javascript code are run inside the extension - for security reasons they must be installed along with other extension files.

If you have ideas for further tests please let us know!