Return-Path: X-Original-To: apmail-incubator-callback-commits-archive@minotaur.apache.org Delivered-To: apmail-incubator-callback-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 1317C92FC for ; Tue, 3 Jan 2012 18:40:54 +0000 (UTC) Received: (qmail 53259 invoked by uid 500); 3 Jan 2012 18:40:54 -0000 Delivered-To: apmail-incubator-callback-commits-archive@incubator.apache.org Received: (qmail 53243 invoked by uid 500); 3 Jan 2012 18:40:54 -0000 Mailing-List: contact callback-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: callback-dev@incubator.apache.org Delivered-To: mailing list callback-commits@incubator.apache.org Received: (qmail 53235 invoked by uid 99); 3 Jan 2012 18:40:53 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 03 Jan 2012 18:40:53 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.114] (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 03 Jan 2012 18:40:39 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 70FCF3156B2; Tue, 3 Jan 2012 18:39:31 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: pmuellr@apache.org To: callback-commits@incubator.apache.org X-Mailer: ASF-Git Admin Mailer Subject: [6/27] git commit: updates to the doc Message-Id: <20120103183931.70FCF3156B2@tyr.zones.apache.org> Date: Tue, 3 Jan 2012 18:39:31 +0000 (UTC) X-Virus-Checked: Checked by ClamAV on apache.org updates to the doc for issue CB-1: https://issues.apache.org/jira/browse/CB-1 Biggest change was removing the test drive, and replacing with a "User Interface" page. Re-doing all the screen shots. Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/commit/50adc4a2 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/tree/50adc4a2 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/diff/50adc4a2 Branch: refs/heads/master Commit: 50adc4a2ba11fef84d467628c4b6648409e0cccf Parents: 87625ae Author: Patrick Mueller Authored: Thu Oct 27 13:15:14 2011 -0400 Committer: Patrick Mueller Committed: Thu Oct 27 13:15:14 2011 -0400 ---------------------------------------------------------------------- README.md | 2 +- weinre.build/README.md | 46 ++--- weinre.build/build.xml | 23 +- weinre.build/sample.personal.properties | 30 +-- weinre.doc/Building.body.html | 19 +- weinre.doc/ChangeLog.body.html | 16 +- weinre.doc/Home.body.html | 120 +++++----- weinre.doc/Installing.body.html | 6 +- weinre.doc/MultiUser.body.html | 22 +- weinre.doc/Running.body.html | 123 ++++------ weinre.doc/Security.body.html | 49 +--- weinre.doc/UserInterface.body.html | 234 ++++++++++++++++++ weinre.doc/boilerplate-header.html.txt | 20 +-- weinre.doc/boilerplate-trailer.html.txt | 4 +- weinre.doc/css/main.css | 47 ++-- weinre.doc/images/circled-a.png | Bin 0 -> 2260 bytes weinre.doc/images/circled-b.png | Bin 0 -> 2271 bytes weinre.doc/images/circled-c.png | Bin 0 -> 2324 bytes weinre.doc/images/circled-d.png | Bin 0 -> 2259 bytes weinre.doc/images/circled-e.png | Bin 0 -> 2197 bytes weinre.doc/images/circled-f.png | Bin 0 -> 2149 bytes weinre.doc/images/circled-g.png | Bin 0 -> 2368 bytes weinre.doc/images/circled-h.png | Bin 0 -> 2114 bytes weinre.doc/images/circled-i.png | Bin 0 -> 2030 bytes weinre.doc/images/circled-j.png | Bin 0 -> 2138 bytes weinre.doc/images/gmail-green-target-client.jpg | Bin 416121 -> 0 bytes weinre.doc/images/orig/panel-console.png | Bin 0 -> 124099 bytes weinre.doc/images/orig/panel-elements.png | Bin 0 -> 166098 bytes weinre.doc/images/orig/panel-network.png | Bin 0 -> 125554 bytes weinre.doc/images/orig/panel-remote-console.png | Bin 0 -> 109813 bytes weinre.doc/images/orig/panel-remote.png | Bin 0 -> 124633 bytes weinre.doc/images/orig/panel-resources.png | Bin 0 -> 86286 bytes weinre.doc/images/orig/panel-timeline.png | Bin 0 -> 111742 bytes weinre.doc/images/orig/server-home.png | Bin 0 -> 108514 bytes weinre.doc/images/orig/shell.png | Bin 0 -> 63942 bytes weinre.doc/images/panel-console.png | Bin 0 -> 125870 bytes weinre.doc/images/panel-elements.png | Bin 0 -> 168517 bytes weinre.doc/images/panel-network.png | Bin 0 -> 129191 bytes weinre.doc/images/panel-remote-console.png | Bin 0 -> 111326 bytes weinre.doc/images/panel-remote.png | Bin 0 -> 131251 bytes weinre.doc/images/panel-resources.png | Bin 0 -> 91188 bytes weinre.doc/images/panel-timeline.png | Bin 0 -> 117361 bytes weinre.doc/images/server-home.png | Bin 0 -> 111501 bytes weinre.doc/images/shell.png | Bin 0 -> 63942 bytes weinre.doc/images/weinre-cli-01-h.jpg | Bin 55063 -> 0 bytes weinre.doc/images/weinre-cli-01-p.jpg | Bin 55063 -> 0 bytes weinre.doc/images/weinre-cli-02-h.jpg | Bin 81812 -> 0 bytes weinre.doc/images/weinre-cli-02-p.jpg | Bin 62129 -> 0 bytes weinre.doc/images/weinre-cli-03-h.jpg | Bin 78723 -> 0 bytes weinre.doc/images/weinre-cli-03-p.jpg | Bin 60962 -> 0 bytes weinre.doc/images/weinre-cli-04-h.jpg | Bin 90964 -> 0 bytes weinre.doc/images/weinre-cli-04-p.jpg | Bin 69258 -> 0 bytes weinre.doc/images/weinre-cli-05-h.jpg | Bin 83518 -> 0 bytes weinre.doc/images/weinre-cli-05-p.jpg | Bin 83518 -> 0 bytes weinre.doc/images/weinre-cli-06-h.jpg | Bin 110750 -> 0 bytes weinre.doc/images/weinre-cli-06-p.jpg | Bin 86308 -> 0 bytes weinre.doc/images/weinre-cli-07-h.jpg | Bin 87903 -> 0 bytes weinre.doc/images/weinre-cli-07-p.jpg | Bin 87903 -> 0 bytes weinre.doc/images/weinre-con-01-h.jpg | Bin 38741 -> 0 bytes weinre.doc/images/weinre-con-01-p.jpg | Bin 28953 -> 0 bytes weinre.doc/images/weinre-con-02-h.jpg | Bin 47995 -> 0 bytes weinre.doc/images/weinre-con-02-p.jpg | Bin 47995 -> 0 bytes weinre.doc/images/weinre-demo.jpg | Bin 0 -> 432255 bytes weinre.doc/images/weinre-frn-01-h.jpg | Bin 92283 -> 0 bytes weinre.doc/images/weinre-frn-01-p.jpg | Bin 71087 -> 0 bytes weinre.doc/images/weinre-tar-01-h.jpg | Bin 49132 -> 0 bytes weinre.doc/images/weinre-tar-01-p.jpg | Bin 49132 -> 0 bytes weinre.doc/images/weinre-tar-02-h.jpg | Bin 39392 -> 0 bytes weinre.doc/images/weinre-tar-02-p.jpg | Bin 39392 -> 0 bytes weinre.web/index.html | 6 +- 70 files changed, 449 insertions(+), 318 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index 1a98afb..6860620 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,2 @@ For more information on weinre, please visit -[http://phonegap.github.com/weinre/](http://phonegap.github.com/weinre/) \ No newline at end of file +[https://github.com/callback/callback-weinre/](https://github.com/callback/callback-weinre/) \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.build/README.md ---------------------------------------------------------------------- diff --git a/weinre.build/README.md b/weinre.build/README.md index c4b08a4..e7a43c9 100644 --- a/weinre.build/README.md +++ b/weinre.build/README.md @@ -1,36 +1,29 @@ building weinre =============================================================================== -weinre is currently built using Eclipse. You will need a fairly recent version of Eclipse with the Java IDE tooling installed to use it. - -weinre is made up of five Eclipse projects: +The weinre source base consists of file folders: - `weinre.application` - `weinre.build` - `weinre.doc` - `weinre.server` - `weinre.web` - -When initially loaded into Eclipse you will find many errors in the projects. This is due to the fact that libraries that weinre depends on have not yet been loaded into the workspace. To load these libraries, run the Ant script `weinre.build/build.xml` from the weinre.build directory. - -Ensure the property `USE_JAVAC` is NOT set in the personal.properties file. If this property is set, then the java files in the projects will be compiled with javac instead of being assumed to be built with Eclipse, which may cause problems since Eclipse is also compiling the java files. -When the Ant script completes successfully, a full build will have taken place. The various red X's another issues from Eclipse should be gone. If not: +weinre was originally built using Eclipse, and still maintains Eclipse meta-data so that it can be developed in Eclipse. Each of the folders above maps into a separate project. Note however that the Eclipse-y-ness of the weinre source base is no longer maintained. Please open a bug if there are problems. -- select all projects, right click context menu/Refresh -- use the Eclipse menu item Project/Clean ... +Before running a build, you should copy the `weinre.build/sample.personal.properties` file to the file `weinre.build/personal.properties`, and then customize that file. -This should make everything right. +weinre requires additional code to produce the final jar. These dependencies will be downloaded the first time you run a build, and then won't be downloaded for subsequent builds. You can explicitly get the dependencies by running the `weinre.build/get-vendor.xml` file in Ant, as follows: -You may want to set the Eclipse preference General/Workspace/Refresh automatically to true (checked) so you don't have to Refresh and Clean. + ant -f get-vendor.xml Various transient directories in this project (weinre.build) will be created after the build. They are set to not be stored in the SCM. They include: -- out -- cached -- tmp -- vendor - +- `out` +- `cached` +- `tmp` +- `vendor` + You can delete them whenever you wish, or use the `"clean"` target of the `weinre.build/build.xml` file to delete them. Deleting them will cause the build to take longer, to rebuild what you deleted. The `weinre.build/out` directory in particular contains the final build artifacts: @@ -38,22 +31,17 @@ The `weinre.build/out` directory in particular contains the final build artifact - `weinre.build/out/archives/weinre-doc-{version}.zip` contains the HTML doc for weinre - + - `weinre.build/out/archives/weinre-jar-{version}.zip` - + contains the platform-portable weinre.jar file - + - `weinre.build/out/archives/weinre-mac-{version}.zip` - + contains the Mac OS X weinre.app application - + - `weinre.build/out/archives/weinre-src-{version}.zip` - - contains the source of the projects (copy of what's in the SCM) - -To build while you are developing the weinre code, you can use the quicker-to-build `"build-dev"` target of `weinre.build/build.xml` . This will not build the jars or archives, just rebuilds the bits neccessary to run the server from the Eclipse workspace. A shell script using a Python utility is provided called `"build-continuous.sh"` which you can run and it will run the `"build-dev"` target whenever a relevant source file has changed in the workspace. -building without eclipse -------------------------------------------------------------------------------- + contains the source of the projects (copy of what's in the SCM) -Ensure the property `USE_JAVAC` is set in the `personal.properties` file. If this property is set, then the java files in the projects will be compiled with javac instead of being assumed to be built with Eclipse. +To build while you are developing the weinre code, you can use the quicker-to-build `"build-dev"` target of `weinre.build/build.xml` . This will not build the jars or archives, just rebuilds the bits necessary to run the server transient output directories. http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.build/build.xml ---------------------------------------------------------------------- diff --git a/weinre.build/build.xml b/weinre.build/build.xml index 68bfcc5..e445f61 100644 --- a/weinre.build/build.xml +++ b/weinre.build/build.xml @@ -96,7 +96,7 @@ compile java code ============================================================ --> - + @@ -258,15 +258,15 @@ - - - - - - - - - + + + + + + + + + @@ -593,6 +593,7 @@ + @@ -604,7 +605,7 @@ - + http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.build/sample.personal.properties ---------------------------------------------------------------------- diff --git a/weinre.build/sample.personal.properties b/weinre.build/sample.personal.properties index 82e22f8..22f7204 100644 --- a/weinre.build/sample.personal.properties +++ b/weinre.build/sample.personal.properties @@ -1,7 +1,7 @@ # --- # weinre is available under *either* the terms of the modified BSD license *or* the # MIT License (2008). See http://opensource.org/licenses/alphabetical for full text. -# +# # Copyright (c) 2010, 2011 IBM Corporation # --- @@ -9,26 +9,24 @@ # example of a personal.properties file #------------------------------------------------------------------------------ # Create a file called personal.properties in this directory, and it will -# you to override property settings during the build. -# +# you to override property settings during the build. +# # The personal.properties file is set to not be stored in the SCM. #------------------------------------------------------------------------------ +#------------------------------------------------------------------------------ +# your name, which will be included in the build artifacts +#------------------------------------------------------------------------------ BUILDER: Your Name in Lights -USE_GROWL: true - -USE_JAVAC: false - #------------------------------------------------------------------------------ -# the libraries commented out below are particularly slow to get from their -# originating locations, and are good to cache locally. The definitions -# override those in vendor.properties +# Set to anything to enable the build posting a "done" message to Growl. +# Delete or comment out to not use Growl. #------------------------------------------------------------------------------ +USE_GROWL: yup -#CACHED_LIBRARIES: file:///Users/me/Sites/weinre-cached-libraries - -#SWT_URL_PREFIX: ${CACHED_LIBRARIES} -#JETTY_URL_PREFIX: ${CACHED_LIBRARIES}/jetty -#JAVAX_SERVLET_URL_PREFIX: ${CACHED_LIBRARIES}/jetty -#JSON4J_URL_PREFIX: ${CACHED_LIBRARIES}/wink +#------------------------------------------------------------------------------ +# Set to anything to enable compiling the Java code with Eclipse. +# Delete or comment out to compile the Java code with javac. +#------------------------------------------------------------------------------ +#USE_ECLIPSE: yup http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/Building.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/Building.body.html b/weinre.doc/Building.body.html index 401fe8d..79ab67f 100644 --- a/weinre.doc/Building.body.html +++ b/weinre.doc/Building.body.html @@ -1,21 +1,14 @@ -

The source repository for weinre is maintained at -GitHub. +

The source repository for weinre is maintained at +GitHub. -

To build the current version of weinre, you will -probably want to use Eclipse. If that's not an option, there is some -experimental support in the main ant build script to compile the Java code -outside of Eclipse. Explore the build.xml file to see how that's -done. - -

At development time, weinre consists of 5 Eclipse -projects. See the file README.md in the -weinre.build project for more instructions on +

At development time, weinre consists of 5 +directories / Eclipse projects. See the file README.md in the +weinre.build directory for more instructions on how to perform a build. - http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/ChangeLog.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/ChangeLog.body.html b/weinre.doc/ChangeLog.body.html index 432c26c..5df5dce 100644 --- a/weinre.doc/ChangeLog.body.html +++ b/weinre.doc/ChangeLog.body.html @@ -1,14 +1,14 @@

Downloads

-

https://github.com/phonegap/weinre/downloads +

https://github.com/callback/callback-weinre/downloads

2011/07/22 - version 1.5.0

@@ -23,22 +23,22 @@ the database to see it listed here. Databases which you have previously created in other browsing sessions will not be displayed until they are first opened.

Clicking on a database table will dump the database contents to the panel. -Clicking on the database itself will provide a prompter for you to run SQL -commands against that database. For example, entering -"select * from YourTableNameHere" +Clicking on the database itself will provide a prompter for you to run SQL +commands against that database. For example, entering +"select * from YourTableNameHere" will dump the table contents to the panel.

  • Some of the console functions, like console.log(), were not handling object arguments correctly. You should now see a an object display. For example, -typing "window" or "console.log(window)" into the console +typing "window" or "console.log(window)" into the console will show you the same object display for the window. -

  • The ant build script did not have the correctly-cased file names for some +

  • The ant build script did not have the correctly-cased file names for some of the files, and the build failed. This has been fixed. You should be able to do a build on Linux, and other case-sensitive file systems.

  • While weinre already removes some of the Web Inspector panels wholesale, -there were still a number of meaningless gee-gaws on the panels that we do show. +there were still a number of meaningless gee-gaws on the panels that we do show. Those have been surgically removed with CSS. http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/Home.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/Home.body.html b/weinre.doc/Home.body.html index 5cf5dc2..f5ef7de 100644 --- a/weinre.doc/Home.body.html +++ b/weinre.doc/Home.body.html @@ -2,110 +2,106 @@ -

    weinre is Web Inspector Remote. +

    weinre is WEb INspector REmote. Pronounced like the word "winery". Or maybe like the word "weiner". Who knows, really. -

    Interesting places: -

    - -

    It's a debugger for web pages, like +

    weinre is a debugger for web pages, like FireBug (for FireFox) -and +and Web Inspector (for WebKit-based browsers), except it's designed to work remotely, and in particular, to allow you debug web pages on a mobile device such as a phone. -

    If you aren't familiar with FireBug or Web Inspector, +

    Interesting places to visit: + +
    - videos at YouTube: http://www.youtube.com/results?search_query=weinre +
    - this documentation at GitHub: http://callback.github.com/callback-weinre +
    - source at GitHub: https://github.com/callback/callback-weinre +
    - discussion at Google Group: http://groups.google.com/group/weinre +
    + +

    More information on weinre's big brothers, Web Inspector / Google Chrome +Developer Tools, is available at +Google's Chrome Dev Tools pages +and +Apple's Web Inspector pages. + +

    If you aren't familiar with FireBug or Web Inspector, weinre isn't going to make too much sense to you. weinre reuses the user interface code from the Web Inspector project at WebKit, -so if you've used Safari's Web Inspector or Chrome's Developer Tools, +so if you've used Safari's Web Inspector or Chrome's Developer Tools, weinre will be very familiar. If you're not -familiar with Web Inspector, the link above to Google Chrome Developer Tools -provides some documentation Real Web Inspector, which weinre is based on. - - +

    Here's an example session using weinre: -

    Here's what you can do with it: +

    -

    +

    Two screen captures are shown above. On the left is the +weinre client application, displaying debug +information. +On the right is the target web page, running in Mobile Safari in the iOS Simulator. -

    Two screen captures are shown above. +

    In normal usage, you will be running the client application in a browser +on your desktop/laptop, and running a target web page on your mobile device. -

    The screen capture on the left is from an -iPod Touch, running the Mobile Safari app, visiting a browser-based email web site -you may be familiar with. - -

    The screen capture on the right is the from a laptop computer, running the -weinre debug client, debugging the web page on the left. The DOM being displayed -in the elements panel is from the HTML being displayed in the web browser on the iPod Touch. - -

    You might think that green background in the email client is a bit horrifying. -It's not normally green. I made it green by executing the following JavaScript code -in the weinre console area (as you can see above): +

    In the session above, the debugger is display the Elements panel, with the +embedded console expanded in the bottom third of the window. In the console +area, we've entered two statements:

    -document.body.style.background = "green"
    +document.body.style.backgroundColor
    +document.body.style.backgroundColor = "pink"
     
    +

    The result of running the first statement shows the value of the body's background style is not set. +The second statement sets the body's background to pink. That horrifying pink +background is then rendered in the target's window. + +

    In addition, an h1 element is selected in the upper third of the +Elements panel, which causes the side panels on the right to be filled in with +relevant information. In this case, the matched CSS rules for that h1 +element are being shown. +

    If you are familiar with WebKit's Web Inspector, a partial list of differences between it and weinre are listed below:

      -
    • weinre does not make use of any 'native' code, +
    • weinre does not make use of any 'native' code, it's all JavaScript (and currently Java code for the 'server'). -
    • Because weinre doesn't use 'native' code, +
    • Because weinre doesn't use 'native' code, it's functionality is limited. For instance, source level debug of JavaScript -is not possible. - -
    • Because weinre doesn't use 'native' code, +is not possible +easy. + +
    • Because weinre doesn't use 'native' code, the debug target code will run on browsers without specialized debug support. For instance, a browser running on your phone. - -
    • weinre supports 'remote' interaction, -so you can run the debugger user interface on one + +
    • weinre supports 'remote' interaction, +so you can run the debugger user interface on one machine and can debug a web page running on another machine. For instance, debug a web page displayed on your phone from your laptop. - -
    • Because weinre supports 'remote' interaction, + +
    • Because weinre supports 'remote' interaction, multiple debug clients can be debugging the same debug target at the same time.
    • One thing not different from Web Inspector is that the debug client -user interface only runs on WebKit-based browsers. Sorry folks. +user interface only runs on WebKit-based browsers.
    -

    Find out more by clicking one of the links at the top or bottom of the page -- to see a walkthrough of -how to use it, visit the Test Drive. -

    Supported Libraries and Platforms

    @@ -127,7 +123,7 @@ but let us know.
  • versions of Prototype.js before version 1.7 are not supported, as they do not support the JSON.stringify() API correctly. You will get an alert() in the web page you are debugging if you -attempt to debug it with weinre and you are using an unsupported +attempt to debug it with weinre and you are using an unsupported version of Prototype.js. @@ -137,7 +133,7 @@ version of Prototype.js.
    • weinre Mac application - Mac OS X 10.6 64-bit
    • Google Chrome 8.x -
    • Apple Safari 5.x +
    • Apple Safari 5.x

    Platforms supported - debug target

    http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/Installing.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/Installing.body.html b/weinre.doc/Installing.body.html index a723711..b94638a 100644 --- a/weinre.doc/Installing.body.html +++ b/weinre.doc/Installing.body.html @@ -1,13 +1,13 @@

    weinre is shipped as two archives available at -https://github.com/phonegap/weinre/archives/master +https://github.com/callback/callback-weinre/archives/master

      @@ -19,6 +19,6 @@ available at
    -

    Install the .jar and/or Mac OS X application wherever you wish. +

    Install the .jar and/or Mac OS X application wherever you wish. At runtime, the .jar file is not sensive to the directory it is installed in, or the current directory when it's launched. http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/MultiUser.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/MultiUser.body.html b/weinre.doc/MultiUser.body.html index 460367a..065d892 100644 --- a/weinre.doc/MultiUser.body.html +++ b/weinre.doc/MultiUser.body.html @@ -1,12 +1,12 @@

    weinre was originally designed so that each user -that wanted to use weinre would run their own +that wanted to use weinre would run their own weinre server. The system has since been enhanced to support muliple users using the same server. @@ -17,17 +17,17 @@ to support muliple users using the same server. id will be used in the client and target URLs of weinre to scope your clients and targets from the clients and targets of other users. -

    There is no password, just an id. There is no real security here. +

    There is no password, just an id. There is no real security here. The id is a secret shared between your debug target and client, but it is sent in the clear when your target and client connect to the server. If someone else knows your id, they can connect to clients or targets you are running with that id. -

    So don't give your id to anyone else that you don't want to share +

    So don't give your id to anyone else that you don't want to share with.

    To keep your id's familar but non-guessable, you might use a string -consisting of your typical userid, followed by a dash, followed by another +consisting of your typical userid, followed by a dash, followed by another string not likely to be guessed by other people.

    If you are paranoid, you can change your id every time you start @@ -37,7 +37,7 @@ a debug session, of course.

    Using your id with the client

    Typically when start a weinre client session -by visiting a URL like +by visiting a URL like

     http://some.server.xyz/client/
    @@ -45,8 +45,8 @@ http://some.server.xyz/client/
     
     

    To start a client with a particular id, append the hash character (#) and -the id you want to use the URL. For instance, to connect with the id -itsReallyMe, launch the client with the URL +the id you want to use the URL. For instance, to connect with the id +itsReallyMe, launch the client with the URL

     http://some.server.xyz/client/#itsReallyMe
    @@ -78,16 +78,16 @@ used a <script src> element of:
     
    • The weinre server always runs in multi-user -mode. If you don't otherwise specify an id, the value of +mode. If you don't otherwise specify an id, the value of anonymous will be used for the id.
    • The id is passed in the HTTP body of a POST request during the initial connection of the target and client to the server, and is not sent thereafter. Thus, it should remain out of view in server logs and the like, -though it will be visible for anyone who has access to the contents of +though it will be visible for anyone who has access to the contents of HTTP request bodies. -
    • There is no programmatic interface on the weinre +
    • There is no programmatic interface in weinre to list id's in current use, for security reasons. From the Remote panel of weinre, each connected client and target have their channel and id's listed, if you can't remember what id you used with the client. http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/Running.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/Running.body.html b/weinre.doc/Running.body.html index 8af91d8..6a63add 100644 --- a/weinre.doc/Running.body.html +++ b/weinre.doc/Running.body.html @@ -1,7 +1,7 @@ @@ -19,26 +19,26 @@ each other.
      Debug Server -
      This is the HTTP server that you run from the weinre.jar file +
      This is the HTTP server that you run from the weinre.jar file or the Mac application. It's the HTTP server that's used by the Debug Client and Debug Target.
      Debug Client -
      This is the Web Inspector user interface; the web page which -displays the Elements and Console panels, for instance. +
      This is the Web Inspector user interface; the web page which +displays the Elements and Console panels, for instance.
      Debug Target
      This is your web page that you want to debug. This name (Debug Target) is also used to refer to the machine running the browser displaying the web page. Since a design -point of weinre is to allow +point of weinre is to allow debugging applications on mobile devices, the debug target, when speaking of the machine, is your mobile -device. +device.
      -

      Both the Debug Client and the Debug Target communicate to +

      Both the Debug Client and the Debug Target communicate to the Debug Server via HTTP using XMLHttpRequest (XHR).

      Typically, you run both the Debug Client and the Debug Server @@ -47,7 +47,7 @@ on your desktop/laptop, and the Debug Target on your mobile device.

      When using the Mac application, the Debug Client and Debug Server are running in the same process. -When you launch the application, +When you launch the application, the server starts, and then the browser included in the application is launched on the appropriate URL automagically. @@ -75,7 +75,7 @@ to function as a Debug Target.

      Running the debug server using the weinre.jar file

      -

      To run weinre from the jar file, +

      To run weinre from the jar file, execute the following command:

      @@ -101,11 +101,11 @@ java -jar path/to/weinre.jar [options]
       

      The ip address to bind the server to.

      Default: localhost - +

      With the default of localhost, you won't be able to access the server from any machine other than the one the server is running on. You will need to bind to another hostname / ip address to make the server accessible to other -machines. You can use the value -all- to indicate that you +machines. You can use the value -all- to indicate that you want to bind to all interfaces available on the current machine.

      Use ifconfig on Linux or the Mac, and ipconfig @@ -120,7 +120,7 @@ on Windows, to get the ip addresses available on your machine.

    • --reuseAddr [true | false]
      -

      Sets the "reuseAddr" flag for Jetty. +

      Sets the "reuseAddr" flag for Jetty.

      Default: false

      May be needed if you restart your server frequently. @@ -133,10 +133,10 @@ to be available to send to the target or client.

      Default: 5

      Can probably be set larger, but then your browser may -time out. Probably don't want to set it much lower than +time out. Probably don't want to set it much lower than this as it will cause additional network traffic when no messages are being sent (it will cause more "empty" -messages to be sent). +messages to be sent).

    • --deathTimeout [seconds] @@ -152,10 +152,10 @@ it much longer.
    -

    You may also create a file named -server.properties in the +

    You may also create a file named +server.properties in the directory .weinre in your -home directory (eg. +home directory (eg. ~/.weinre/server.properties). The keys should be the same as the name of the options above, @@ -166,17 +166,22 @@ file might look like this:

     boundHost:    -all-
    -httpPort:     8081 
    -reuseAddr:    true 
    -readTimeout:  1 
    +httpPort:     8081
    +reuseAddr:    true
    +readTimeout:  1
     deathTimeout: 5
     

    Command-line options override the options specified in the -~/.weinre/server.properties file. +~/.weinre/server.properties file.

    The server will run until you kill it. Control-C will do the job. +

    Below is what you should see from the console after running +weinre from the weinre.jar file. + +

    +

    Running the debug server using the Mac application

    @@ -199,8 +204,8 @@ in a separate tab.

    Running the debug server bound to something other than localhost

    -

    Since the web page you want to debug (the debug target) is probably running on -a different machine (your mobile device) than the debug server (your desktop / laptop), +

    Since the web page you want to debug (the debug target) is probably running on +a different machine (your mobile device) than the debug server (your desktop / laptop), you can't use the default localhost value for the --boundHost option. Instead, you will need to specify a host name / ip address @@ -217,12 +222,12 @@ debug target should use. If you've use the using the URL http://localhost:[portNumber]/client/ from the same machine the debug server is running on. On that page, under Server Properties, is a list of bound hosts -that the server believes it's available on. +that the server believes it's available on. -

    From the debug target device (eg, your mobile device), +

    From the debug target device (eg, your mobile device), try accessing the server home page from all of those host names, using the URL -http://[host name / ipaddress]:[portNumber]/. +http://[host name / ipaddress]:[portNumber]/. Once you find one that displays the server's home page correctly, remember that host name / ip address, we'll be using it in a minute. @@ -245,21 +250,21 @@ will be accessible from the debug target. Let's say that URL

    To make your web page debuggable with weinre, add the following line to your web page:

    -<script src="http://a.b.c:8081/target/target-script-min.js"></script> 
    +<script src="http://a.b.c:8081/target/target-script-min.js"></script>
     

    You can now open a debug client by browsing to -http://a.b.c:8081/client -(or probably +http://a.b.c:8081/client +(or probably http://localhost:8081/client -as well) on your desktop/laptop, -then reload your newly instrumented web page on your mobile device, +as well) on your desktop/laptop, +then reload your newly instrumented web page on your mobile device, and see the two connect in the Remote panel of the debug client.

    Hardcoding host names / IP addresses in your web page?

    -

    Yeah, gross. +

    Yeah, gross.

    Besides being gross, there are a few practical problems with hardcoding the debug server address in your web page as well: @@ -269,7 +274,7 @@ debug server address in your web page as well:

  • Your html file is probably stored in an SCM, and you don't really want to be storing that address in the SCM. It won't work for other people using that html file, -for instance. +for instance.

    But you don't want to be keeping the <script src=""> line in your SCM either. @@ -277,13 +282,13 @@ You should look for a way, as part of your personal build process to add that line only for development builds, and presumably with a user-customizable URL. -

  • The URL the debug server runs on may be -different depending on your location. At work, you may use +
  • The URL the debug server runs on may be +different depending on your location. At work, you may use one IP address and host name; at home, you likely have a different IP address and host name. You may not have a host name at all, just an IP address (which is fine - a host name isn't required, but usually makes things easier). You may be running on a -dynamically assigned IP address, in which case your IP +dynamically assigned IP address, in which case your IP changes every time you log into your network.

    One way out of the dilemma is to use a dynamic @@ -296,13 +301,13 @@ some links to such services: can arrange to use the same host name for your debug server no matter what network you are connected to. - +

    Using a bookmarklet

    Some platforms support 'bookmarkets', which allow you to inject -arbitrary JavaScript code into any web page running in your +arbitrary JavaScript code into any web page running in your browser. Mobile Safari is one of these browsers. It appears that the browser shipped with Android 2.2 and later also supports bookmarklets. @@ -317,45 +322,3 @@ paste into the previously added bookmark.

    Once the bookmarklet is installed, you can debug any web page by visiting it, and selecting the bookmarklet from your bookmarks menu. - - -

    Using the target/target-script-min.js file statically

    - -

    If you'd like to use the debug target code statically, instead of -downloading it from the server all the time, then you will need to do -one more thing. The debug target code computes the address of the -debug server from the src attribute in the -<script> tag, and it won't -be correct in the static case. Instead you can set the -following variable to be the URL of the debug server: - -

    -window.WeinreServerURL
    -
    - -

    This URL overrides what's otherwise calculated from the debug target -code itself. You will need to set this value before the -target/target-script-min.js script is loaded. - - -

    Future Enhancements

    - -

    The calculation of the debug server url by the debug target is a bit fragile and -ham-fisted. We should look at additional ways to handle this. -For instance, we could prompt the user for the debug server -address, and then always using the debug target in a more static -mode; eg, you'd include the target-script-min.js with all your -other files in your application. - -

    Running the debug server on the target device is another option. -This shouldn't be a huge problem for Android, but is more of a problem -on iOS. By running the debug server on the target device, the -debug target can always connect to the debug server by using a -localhost hostname. The debug client, running on your -desktop/laptop, would then need to connect to the target device -to debug. In practice this may be an easier scenario to work with, -as the potentially changing IP address of the mobile device just -means having to type a different URL in your web browser on your desktop / laptop -when running the debug client. That's easier than hard-coding -URLs in your web page, for instance. - http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/Security.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/Security.body.html b/weinre.doc/Security.body.html index ab1d4ad..14e1ee3 100644 --- a/weinre.doc/Security.body.html +++ b/weinre.doc/Security.body.html @@ -1,7 +1,7 @@ @@ -16,10 +16,10 @@ no level of authentication for requests.

    The primary security exposure with weinre is via -the debug server. +the debug server.

    Currently, the server only reads files from the weinre.jar file, -and from the ~/.weinre/ directory (for property files). +and from the ~/.weinre/ directory (for property files). The only thing the server writes to is stdout and stderr.

    If you use the default --boundHost option value of @@ -27,16 +27,16 @@ The only thing the server writes to is stdout and stderr. server can communicate with the debug server. This probably isn't a big deal, since presumably you control the software running on that machine. -

    If you use a non-default --boundHost option value, +

    If you use a non-default --boundHost option value, then any software on any machine that can access that specified host can communicate with the debug server. This is a much bigger deal.

    The most obvious exposure with using --boundHost and -a specific hostname / ip address, is that any debug client or +a specific hostname / ip address, is that any debug client or debug target that can access that hostname / ip address can access -the server. For example, a rogue debug client could connect to -your debug target and fiddle about with it. +the server. For example, a rogue debug client could connect to +your debug target and fiddle about with it.

    Other exposures include leaving a debug target injection script line (ie, <script src="[...]/target/target-script.js">) @@ -48,39 +48,6 @@ server running at that address.

      - -
    • use HTTPS with basic auth - -

      This shouldn't be a big problem with the debug client, but may be a pain in the ass -since basic auth can be a pain in the ass (trying to log out of it). - -

      On the debug target side, this is tougher, since the only HTTP access is done via -XHR. So, presumably, we will need to tack on the userid/password to XHR requests, -unless the browsers do that for us. That is, I assume the browsers don't throw up -a password prompt when an XHR returns with an auth-required response code. - -

      Storing userid/passwords on the client isn't going to be much fun. How do we even -get these from the user? - -

      Note that there is also a 'server discovery' issue we may want to do something -about. That is, how does the debug target even know the URL of the server? -If we want to allow the user to "enter it from the target", then entering the -userid/password can fit into the same scheme, I guess. - -

      Will need some light-weight userid/password store for the server, if -we do this. - -

      Will need to get the horrifying SSL keystore dance crap with Java -in some kind of usable state. Should we ship a working, basic self-signed keystore -that we recommend user's replace? - -

    • use HTTPS with OAuth - -

      Been a while, not sure if OAuth even helps with this, -or how hard it would be to integrate support for it. - -

      Same issue with HTTPS and the SSL keystore above. - -

    • other ideas? +
    • Let's chat
    http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/UserInterface.body.html ---------------------------------------------------------------------- diff --git a/weinre.doc/UserInterface.body.html b/weinre.doc/UserInterface.body.html new file mode 100644 index 0000000..b5a95cd --- /dev/null +++ b/weinre.doc/UserInterface.body.html @@ -0,0 +1,234 @@ + + +

    This page describes the user interface provided by weinre. + + +

    the server home page

    + +

    + +

    The server home page is accessed at the root URL of the server, in this case +http://localhost:8081/. + +
    +This link will launch the +weinre client page, which is the debugger itself. +Clicking this link will take you to the Remote panel, described below. +
    + +

    +This is the URL of the script that you add to your +web page to allow it to be debugged by the client. +
    + +

    Additional links shown in this image are for this documentation, and some demo +pages. + +

    Further down on the page, not shown in the image, are: + +

      +
    • The text of the <script src=> element you can copy and paste into your +web page. +
    • The source for a bookmarklet, to inject the debug code into any web +page displayed in your browser. +
    • Version numbers of weinre and it's components. +
    + + +

    the Remote panel

    + +

    + +

    The Remote panel is the initial panel of weinre, +and displays some status regarding the server. + +
    +The top portion of all of the +weinre panels shows the panel switcher. To switch +to a different panel, click on the panel's button. The current panel is displayed with +a highlight, as shown above for the Remote panel. +
    + +

    +The Targets section of this page lists targets that are currently connected +to the server. A target is a web page that you are debugging. +In this case, there is one target connected the server. Information +about each target is displayed in the list, including host name / ip address, and +the URL the target is displaying. +
    + +

    +The Clients section of this page lists the clients that are currently connected +to the server. A client is this user interface. Typically, there is just one - the client you are displaying +at the time. +
    + +

    +The Server Properties section of this page displays the values of various server +properties currently in effect. Shown here are the hosts that are bound to the +server - which host names / ip addresses that the server will respond to. +
    + +

    The colors of the entries in the Targets and Clients list indicates their +status. Blue means the Target or Client is connected to the server, but not +yet connected to a peer. Green means the Target or Client is connected to a +peer, and you can start debugging. Red means the Target or Client has +disconnected from the server, and will eventually fade away and be removed +from the list. + +

    In case there are multiple targets connected, you can switch which one you +are debugging by clicking on the item. + + +

    the Elements panel

    + +

    + +

    The Elements panel displays your HTML DOM in a tree fashion, and properties +associated with selected elements. + +
    +The elements themselves may be expanded/collapsed via the disclosure buttons. +Elements and text can be edited by double-clicking the item to be edited. +Elements can also be deleted by selecting the element and then pressing the +delete button. +
    + +

    +The sidebar area displays information about the selected element. In this case, +the Styles sidebar is expanded, showing relevant CSS rules. Some sidebars allow +editing of the contents. The Styles sidebar in particular allows you to add, edit +and remove properties and values by double clicking on them. +
    + + +

    the Resources panel

    + +

    + +

    The Resources panel shows WebSQL databases, and data stored in Local Storage +and Session Storage. + +
    +The left hand side of the Resources panel is the navigator. Expanding +the Databases entry will show all the Web SQL databases currently in use. +Expanding a particular database will show all the tables in that database. + +
    + +

    +The right hand side is the editor/viewer for whatever is selected in the +navigator pane. +When a database is selected, a prompt will appear in the editor/viewer area +where you can enter SQL statements to be executed. The results are displayed +inline. When a table is selected, all the rows from the table will be displayed. +When a Local Storage or Session Storage entry is selected, all the relevant keys +and values will be displayed. The keys and values in the Local Storage and +Session Storage tables can be edited by double-clicking. +
    + +

    +The reload button will refresh the data from the target. +
    + + +

    the Network panel

    + +

    + +

    The Network panel shows you information regarding XHR requests that you've +made. + +
    +Each XHR will be shown in a separate row in the table. Clicking the +path name of the XHR request will show additional information for that +request in the right side of the panel. +To display the table again, click the (x) +button in the left top corner of the information pane (not shown in the +image above). +
    + +

    +The "dots and lines" button can be used to change the table layout to +show less information in a more compact format. +
    + +

    +The "not" button will clear the entries from the table. +
    + + +

    the Timeline panel

    + +

    + +

    The Timeline panel is used to show events that are occurring in the target. +Currently only two types of events are shown: timers/intervals, and user-specified +events. Use console.markTimeline("A Label") to add a user-specified +event to the timeline with the specified label. + +

    Note that timing events are not collected unless you enable the "record" +button (see below). + +
    +The left hand pane of the Timeline panel shows the events that have occurred. +Hovering over an entry will show additional detail about the event. +
    + +

    +The right hand pane of the Timeline panel shows the events as they occurred +in time. Some events have other events associated with them, which will be shown +when the disclosure triangle is expanded. The top-most time line of the right +panel can have it's right and left hand edges moved to show a particular time +range in more detail. +
    + +

    +The "dots and lines" button can be used to show and hide events that last +less than a fixed time (currently 15ms). +
    + +

    +The "record" button is used to start or stop event collection. When +weinre starts, the record button is off (black). +When you click the record button to start collecting events, it will turn +red. +
    + +

    +The "not" button will clear the current timing entries. +
    + + + +

    the Console panel

    + +

    + +

    The Console panel is used to execute arbitrary JavaScript expressions/statements. It +also shows the output from various console methods, like +console.log(). + +

    In the example above, the JavaScript statements entered by the user are in +blue, the output of the statements is just below it, and messages generated by +console.log() are in black. + +
    +The "not" button will clear the console. +
    + +

    + +

    The Console can also be embedded in every panel, by clicking the "console" +button. + +
    +The "console" button will embed the console in the bottom half of the +other panels, or hide it if it's currently embedded in the other panels. +
    + http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/boilerplate-header.html.txt ---------------------------------------------------------------------- diff --git a/weinre.doc/boilerplate-header.html.txt b/weinre.doc/boilerplate-header.html.txt index f237a28..73acd31 100644 --- a/weinre.doc/boilerplate-header.html.txt +++ b/weinre.doc/boilerplate-header.html.txt @@ -3,7 +3,7 @@ @@ -12,32 +12,18 @@ weinre - @PAGE_NAME@ - - -

    +
    Fork weinre on GitHub

    weinre - @PAGE_NAME@

    Home -- Test Drive +- User Interface - Installing - Running - Multi-User http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/boilerplate-trailer.html.txt ---------------------------------------------------------------------- diff --git a/weinre.doc/boilerplate-trailer.html.txt b/weinre.doc/boilerplate-trailer.html.txt index 7c782f5..f2244a0 100644 --- a/weinre.doc/boilerplate-trailer.html.txt +++ b/weinre.doc/boilerplate-trailer.html.txt @@ -3,7 +3,7 @@ @@ -11,7 +11,7 @@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    Home -- Test Drive +- User Interface - Installing - Running - Multi-User http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/css/main.css ---------------------------------------------------------------------- diff --git a/weinre.doc/css/main.css b/weinre.doc/css/main.css index 850bd78..ba071e2 100644 --- a/weinre.doc/css/main.css +++ b/weinre.doc/css/main.css @@ -1,7 +1,7 @@ /* * weinre is available under *either* the terms of the modified BSD license *or* the * MIT License (2008). See http://opensource.org/licenses/alphabetical for full text. - * + * * Copyright (c) 2010, 2011 IBM Corporation */ @@ -17,8 +17,8 @@ body { left: 0; border-right: thin solid #000; border-bottom: thin solid #000; - -moz-border-radius-bottomright: 0.5em; - -webkit-border-bottom-right-radius: 0.5em; + -moz-border-radius-bottomright: 0.5em; + -webkit-border-bottom-right-radius: 0.5em; padding: 0.25em 0.5em; background-color: #FF0; font-style: italic; @@ -33,6 +33,11 @@ body { } /*-----------------------------------------------------------------*/ +.strike { + text-decoration: line-through; +} + +/*-----------------------------------------------------------------*/ .weinre { color: #088; font-style: italic; @@ -123,9 +128,9 @@ tt { padding: 0.00em 0.5em; border-width: 1; border-style: solid; - border-radius: 0.5em; - -moz-border-radius: 0.5em; - -webkit-border-radius: 0.5em; + border-radius: 0.5em; + -moz-border-radius: 0.5em; + -webkit-border-radius: 0.5em; } /*-----------------------------------------------------------------*/ @@ -140,29 +145,29 @@ pre, xmp { margin-left: 1.4em; margin-right: 1.4em; background: #FFFFDF; - border-radius: 0.5em; - -moz-border-radius: 0.5em; - -webkit-border-radius: 0.5em; - box-shadow: 0.3em 0.3em 0.3em 0em #DDD; - -moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; - -webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; + border-radius: 0.5em; + -moz-border-radius: 0.5em; + -webkit-border-radius: 0.5em; + box-shadow: 0.3em 0.3em 0.3em 0em #DDD; + -moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; + -webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; } /*-----------------------------------------------------------------*/ h2 { padding: 0.25em 0.50em; background-color: #DDD; - border-radius: 0.5em; - -moz-border-radius: 0.5em; - -webkit-border-radius: 0.5em; + border-radius: 0.5em; + -moz-border-radius: 0.5em; + -webkit-border-radius: 0.5em; } /*-----------------------------------------------------------------*/ kewl { - box-shadow: 0.3em 0.3em 0.3em 0em #DDD; - -moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; - -webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; - border-radius: 0.5em; - -moz-border-radius: 0.5em; - -webkit-border-radius: 0.5em; + box-shadow: 0.3em 0.3em 0.3em 0em #DDD; + -moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; + -webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD; + border-radius: 0.5em; + -moz-border-radius: 0.5em; + -webkit-border-radius: 0.5em; } http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-a.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-a.png b/weinre.doc/images/circled-a.png new file mode 100644 index 0000000..98c0558 Binary files /dev/null and b/weinre.doc/images/circled-a.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-b.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-b.png b/weinre.doc/images/circled-b.png new file mode 100644 index 0000000..0d80f3c Binary files /dev/null and b/weinre.doc/images/circled-b.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-c.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-c.png b/weinre.doc/images/circled-c.png new file mode 100644 index 0000000..f876019 Binary files /dev/null and b/weinre.doc/images/circled-c.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-d.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-d.png b/weinre.doc/images/circled-d.png new file mode 100644 index 0000000..8e58ca8 Binary files /dev/null and b/weinre.doc/images/circled-d.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-e.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-e.png b/weinre.doc/images/circled-e.png new file mode 100644 index 0000000..f3a782a Binary files /dev/null and b/weinre.doc/images/circled-e.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-f.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-f.png b/weinre.doc/images/circled-f.png new file mode 100644 index 0000000..4998913 Binary files /dev/null and b/weinre.doc/images/circled-f.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-g.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-g.png b/weinre.doc/images/circled-g.png new file mode 100644 index 0000000..888bcee Binary files /dev/null and b/weinre.doc/images/circled-g.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-h.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-h.png b/weinre.doc/images/circled-h.png new file mode 100644 index 0000000..174d731 Binary files /dev/null and b/weinre.doc/images/circled-h.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-i.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-i.png b/weinre.doc/images/circled-i.png new file mode 100644 index 0000000..338c341 Binary files /dev/null and b/weinre.doc/images/circled-i.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/circled-j.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/circled-j.png b/weinre.doc/images/circled-j.png new file mode 100644 index 0000000..6595d75 Binary files /dev/null and b/weinre.doc/images/circled-j.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/gmail-green-target-client.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/gmail-green-target-client.jpg b/weinre.doc/images/gmail-green-target-client.jpg deleted file mode 100644 index 778916a..0000000 Binary files a/weinre.doc/images/gmail-green-target-client.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-console.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-console.png b/weinre.doc/images/orig/panel-console.png new file mode 100644 index 0000000..3a8d794 Binary files /dev/null and b/weinre.doc/images/orig/panel-console.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-elements.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-elements.png b/weinre.doc/images/orig/panel-elements.png new file mode 100644 index 0000000..4b81020 Binary files /dev/null and b/weinre.doc/images/orig/panel-elements.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-network.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-network.png b/weinre.doc/images/orig/panel-network.png new file mode 100644 index 0000000..6cc5a59 Binary files /dev/null and b/weinre.doc/images/orig/panel-network.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-remote-console.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-remote-console.png b/weinre.doc/images/orig/panel-remote-console.png new file mode 100644 index 0000000..14db266 Binary files /dev/null and b/weinre.doc/images/orig/panel-remote-console.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-remote.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-remote.png b/weinre.doc/images/orig/panel-remote.png new file mode 100644 index 0000000..0a5374c Binary files /dev/null and b/weinre.doc/images/orig/panel-remote.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-resources.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-resources.png b/weinre.doc/images/orig/panel-resources.png new file mode 100644 index 0000000..2b1a2fc Binary files /dev/null and b/weinre.doc/images/orig/panel-resources.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/panel-timeline.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/panel-timeline.png b/weinre.doc/images/orig/panel-timeline.png new file mode 100644 index 0000000..a5d7ff5 Binary files /dev/null and b/weinre.doc/images/orig/panel-timeline.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/server-home.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/server-home.png b/weinre.doc/images/orig/server-home.png new file mode 100644 index 0000000..4a2628f Binary files /dev/null and b/weinre.doc/images/orig/server-home.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/orig/shell.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/orig/shell.png b/weinre.doc/images/orig/shell.png new file mode 100644 index 0000000..d43f51c Binary files /dev/null and b/weinre.doc/images/orig/shell.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-console.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-console.png b/weinre.doc/images/panel-console.png new file mode 100644 index 0000000..5f43882 Binary files /dev/null and b/weinre.doc/images/panel-console.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-elements.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-elements.png b/weinre.doc/images/panel-elements.png new file mode 100644 index 0000000..c05defa Binary files /dev/null and b/weinre.doc/images/panel-elements.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-network.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-network.png b/weinre.doc/images/panel-network.png new file mode 100644 index 0000000..b2ddcae Binary files /dev/null and b/weinre.doc/images/panel-network.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-remote-console.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-remote-console.png b/weinre.doc/images/panel-remote-console.png new file mode 100644 index 0000000..dcb9e9b Binary files /dev/null and b/weinre.doc/images/panel-remote-console.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-remote.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-remote.png b/weinre.doc/images/panel-remote.png new file mode 100644 index 0000000..08f4749 Binary files /dev/null and b/weinre.doc/images/panel-remote.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-resources.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-resources.png b/weinre.doc/images/panel-resources.png new file mode 100644 index 0000000..e6f5bd2 Binary files /dev/null and b/weinre.doc/images/panel-resources.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/panel-timeline.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/panel-timeline.png b/weinre.doc/images/panel-timeline.png new file mode 100644 index 0000000..f4136ab Binary files /dev/null and b/weinre.doc/images/panel-timeline.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/server-home.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/server-home.png b/weinre.doc/images/server-home.png new file mode 100644 index 0000000..a52815f Binary files /dev/null and b/weinre.doc/images/server-home.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/shell.png ---------------------------------------------------------------------- diff --git a/weinre.doc/images/shell.png b/weinre.doc/images/shell.png new file mode 100644 index 0000000..d43f51c Binary files /dev/null and b/weinre.doc/images/shell.png differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-01-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-01-h.jpg b/weinre.doc/images/weinre-cli-01-h.jpg deleted file mode 100644 index f4edc9a..0000000 Binary files a/weinre.doc/images/weinre-cli-01-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-01-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-01-p.jpg b/weinre.doc/images/weinre-cli-01-p.jpg deleted file mode 100644 index f4edc9a..0000000 Binary files a/weinre.doc/images/weinre-cli-01-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-02-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-02-h.jpg b/weinre.doc/images/weinre-cli-02-h.jpg deleted file mode 100644 index b083a76..0000000 Binary files a/weinre.doc/images/weinre-cli-02-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-02-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-02-p.jpg b/weinre.doc/images/weinre-cli-02-p.jpg deleted file mode 100644 index edcefde..0000000 Binary files a/weinre.doc/images/weinre-cli-02-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-03-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-03-h.jpg b/weinre.doc/images/weinre-cli-03-h.jpg deleted file mode 100644 index e8e4400..0000000 Binary files a/weinre.doc/images/weinre-cli-03-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-03-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-03-p.jpg b/weinre.doc/images/weinre-cli-03-p.jpg deleted file mode 100644 index 52f2e73..0000000 Binary files a/weinre.doc/images/weinre-cli-03-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-04-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-04-h.jpg b/weinre.doc/images/weinre-cli-04-h.jpg deleted file mode 100644 index da42f56..0000000 Binary files a/weinre.doc/images/weinre-cli-04-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-04-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-04-p.jpg b/weinre.doc/images/weinre-cli-04-p.jpg deleted file mode 100644 index 49bd84d..0000000 Binary files a/weinre.doc/images/weinre-cli-04-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-05-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-05-h.jpg b/weinre.doc/images/weinre-cli-05-h.jpg deleted file mode 100644 index 84f48a6..0000000 Binary files a/weinre.doc/images/weinre-cli-05-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-05-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-05-p.jpg b/weinre.doc/images/weinre-cli-05-p.jpg deleted file mode 100644 index 84f48a6..0000000 Binary files a/weinre.doc/images/weinre-cli-05-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-06-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-06-h.jpg b/weinre.doc/images/weinre-cli-06-h.jpg deleted file mode 100644 index 676fee1..0000000 Binary files a/weinre.doc/images/weinre-cli-06-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-06-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-06-p.jpg b/weinre.doc/images/weinre-cli-06-p.jpg deleted file mode 100644 index d4d2b56..0000000 Binary files a/weinre.doc/images/weinre-cli-06-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-07-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-07-h.jpg b/weinre.doc/images/weinre-cli-07-h.jpg deleted file mode 100644 index 2614375..0000000 Binary files a/weinre.doc/images/weinre-cli-07-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-cli-07-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-cli-07-p.jpg b/weinre.doc/images/weinre-cli-07-p.jpg deleted file mode 100644 index 2614375..0000000 Binary files a/weinre.doc/images/weinre-cli-07-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-con-01-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-con-01-h.jpg b/weinre.doc/images/weinre-con-01-h.jpg deleted file mode 100644 index 2051127..0000000 Binary files a/weinre.doc/images/weinre-con-01-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-con-01-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-con-01-p.jpg b/weinre.doc/images/weinre-con-01-p.jpg deleted file mode 100644 index 35ec12e..0000000 Binary files a/weinre.doc/images/weinre-con-01-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-con-02-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-con-02-h.jpg b/weinre.doc/images/weinre-con-02-h.jpg deleted file mode 100644 index a7620e3..0000000 Binary files a/weinre.doc/images/weinre-con-02-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-con-02-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-con-02-p.jpg b/weinre.doc/images/weinre-con-02-p.jpg deleted file mode 100644 index a7620e3..0000000 Binary files a/weinre.doc/images/weinre-con-02-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-demo.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-demo.jpg b/weinre.doc/images/weinre-demo.jpg new file mode 100644 index 0000000..efd5829 Binary files /dev/null and b/weinre.doc/images/weinre-demo.jpg differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-frn-01-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-frn-01-h.jpg b/weinre.doc/images/weinre-frn-01-h.jpg deleted file mode 100644 index 82ad660..0000000 Binary files a/weinre.doc/images/weinre-frn-01-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-frn-01-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-frn-01-p.jpg b/weinre.doc/images/weinre-frn-01-p.jpg deleted file mode 100644 index f631e06..0000000 Binary files a/weinre.doc/images/weinre-frn-01-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-tar-01-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-tar-01-h.jpg b/weinre.doc/images/weinre-tar-01-h.jpg deleted file mode 100644 index 7663c0d..0000000 Binary files a/weinre.doc/images/weinre-tar-01-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-tar-01-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-tar-01-p.jpg b/weinre.doc/images/weinre-tar-01-p.jpg deleted file mode 100644 index 7663c0d..0000000 Binary files a/weinre.doc/images/weinre-tar-01-p.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-tar-02-h.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-tar-02-h.jpg b/weinre.doc/images/weinre-tar-02-h.jpg deleted file mode 100644 index c93cd71..0000000 Binary files a/weinre.doc/images/weinre-tar-02-h.jpg and /dev/null differ http://git-wip-us.apache.org/repos/asf/incubator-cordova-weinre/blob/50adc4a2/weinre.doc/images/weinre-tar-02-p.jpg ---------------------------------------------------------------------- diff --git a/weinre.doc/images/weinre-tar-02-p.jpg b/weinre.doc/images/weinre-tar-02-p.jpg deleted file mode 100644 index c93cd71..0000000 Binary files a/weinre.doc/images/weinre-tar-02-p.jpg and /dev/null differ