Author: msacks
Date: Wed Jan 12 21:04:54 2011
New Revision: 1058316
URL: http://svn.apache.org/viewvc?rev=1058316&view=rev
Log:
added images, subversion config file, and updated index page, added hrefs to
gettingstarted
Added:
incubator/kitty/site/trunk/content/kitty/files/
incubator/kitty/site/trunk/content/kitty/files/config
incubator/kitty/site/trunk/content/kitty/images/
incubator/kitty/site/trunk/content/kitty/images/apache-kitty-eclipse-console.png
(with props)
incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location-url.png
(with props)
incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location.png
(with props)
Modified:
incubator/kitty/site/trunk/content/kitty/gettingstarted.mdtext
Added: incubator/kitty/site/trunk/content/kitty/files/config
URL:
http://svn.apache.org/viewvc/incubator/kitty/site/trunk/content/kitty/files/config?rev=1058316&view=auto
==============================================================================
--- incubator/kitty/site/trunk/content/kitty/files/config (added)
+++ incubator/kitty/site/trunk/content/kitty/files/config Wed Jan 12 21:04:54
2011
@@ -0,0 +1,282 @@
+### This file configures various client-side behaviors.
+###
+### The commented-out examples below are intended to demonstrate
+### how to use this file.
+
+### Section for authentication and authorization customizations.
+[auth]
+### Set password stores used by Subversion. They should be
+### delimited by spaces or commas. The order of values determines
+### the order in which password stores are used.
+### Valid password stores:
+### gnome-keyring (Unix-like systems)
+### kwallet (Unix-like systems)
+### keychain (Mac OS X)
+### windows-cryptoapi (Windows)
+# password-stores = keychain
+###
+### The rest of this section in this file has been deprecated.
+### Both 'store-passwords' and 'store-auth-creds' can now be
+### specified in the 'servers' file in your config directory.
+### Anything specified in this section is overridden by settings
+### specified in the 'servers' file.
+###
+### Set store-passwords to 'no' to avoid storing passwords in the
+### auth/ area of your config directory. It defaults to 'yes',
+### but Subversion will never save your password to disk in
+### plaintext unless you tell it to (see the 'servers' file).
+### Note that this option only prevents saving of *new* passwords;
+### it doesn't invalidate existing passwords. (To do that, remove
+### the cache files by hand as described in the Subversion book.)
+# store-passwords = no
+### Set store-auth-creds to 'no' to avoid storing any subversion
+### credentials in the auth/ area of your config directory.
+### It defaults to 'yes'. Note that this option only prevents
+### saving of *new* credentials; it doesn't invalidate existing
+### caches. (To do that, remove the cache files by hand.)
+# store-auth-creds = no
+
+### Section for configuring external helper applications.
+[helpers]
+### Set editor-cmd to the command used to invoke your text editor.
+### This will override the environment variables that Subversion
+### examines by default to find this information ($EDITOR,
+### et al).
+# editor-cmd = editor (vi, emacs, notepad, etc.)
+### Set diff-cmd to the absolute path of your 'diff' program.
+### This will override the compile-time default, which is to use
+### Subversion's internal diff implementation.
+# diff-cmd = diff_program (diff, gdiff, etc.)
+### Set diff3-cmd to the absolute path of your 'diff3' program.
+### This will override the compile-time default, which is to use
+### Subversion's internal diff3 implementation.
+# diff3-cmd = diff3_program (diff3, gdiff3, etc.)
+### Set diff3-has-program-arg to 'yes' if your 'diff3' program
+### accepts the '--diff-program' option.
+# diff3-has-program-arg = [yes | no]
+### Set merge-tool-cmd to the command used to invoke your external
+### merging tool of choice. Subversion will pass 4 arguments to
+### the specified command: base theirs mine merged
+# merge-tool-cmd = merge_command
+
+### Section for configuring tunnel agents.
+[tunnels]
+### Configure svn protocol tunnel schemes here. By default, only
+### the 'ssh' scheme is defined. You can define other schemes to
+### be used with 'svn+scheme://hostname/path' URLs. A scheme
+### definition is simply a command, optionally prefixed by an
+### environment variable name which can override the command if it
+### is defined. The command (or environment variable) may contain
+### arguments, using standard shell quoting for arguments with
+### spaces. The command will be invoked as:
+### <command> <hostname> svnserve -t
+### (If the URL includes a username, then the hostname will be
+### passed to the tunnel agent as <user>@<hostname>.) If the
+### built-in ssh scheme were not predefined, it could be defined
+### as:
+# ssh = $SVN_SSH ssh -q
+### If you wanted to define a new 'rsh' scheme, to be used with
+### 'svn+rsh:' URLs, you could do so as follows:
+# rsh = rsh
+### Or, if you wanted to specify a full path and arguments:
+# rsh = /path/to/rsh -l myusername
+### On Windows, if you are specifying a full path to a command,
+### use a forward slash (/) or a paired backslash (\\) as the
+### path separator. A single backslash will be treated as an
+### escape for the following character.
+
+### Section for configuring miscelleneous Subversion options.
+#[miscellany]
+### Set global-ignores to a set of whitespace-delimited globs
+### which Subversion will ignore in its 'status' output, and
+### while importing or adding files and directories.
+### '*' matches leading dots, e.g. '*.rej' matches '.foo.rej'.
+# global-ignores = *.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo
+# *.rej *~ #*# .#* .*.swp .DS_Store
+### Set log-encoding to the default encoding for log messages
+# log-encoding = latin1
+### Set use-commit-times to make checkout/update/switch/revert
+### put last-committed timestamps on every file touched.
+# use-commit-times = yes
+### Set no-unlock to prevent 'svn commit' from automatically
+### releasing locks on files.
+# no-unlock = yes
+### Set mime-types-file to a MIME type registry file, used to
+### provide hints to Subversion's MIME type auto-detection
+### algorithm.
+# mime-types-file = /path/to/mime.types
+### Set preserved-conflict-file-exts to a whitespace-delimited
+### list of patterns matching file extensions which should be
+### preserved in generated conflict file names. By default,
+### conflict files use custom extensions.
+# preserved-conflict-file-exts = doc ppt xls od?
+### Set enable-auto-props to 'yes' to enable automatic properties
+### for 'svn add' and 'svn import', it defaults to 'no'.
+### Automatic properties are defined in the section 'auto-props'.
+# enable-auto-props = yes
+### Set interactive-conflicts to 'no' to disable interactive
+### conflict resolution prompting. It defaults to 'yes'.
+# interactive-conflicts = no
+
+### Section for configuring automatic properties.
+#[auto-props]
+### The format of the entries is:
+### file-name-pattern = propname[=value][;propname[=value]...]
+### The file-name-pattern can contain wildcards (such as '*' and
+### '?'). All entries which match (case-insensitively) will be
+### applied to the file. Note that auto-props functionality
+### must be enabled, which is typically done by setting the
+### 'enable-auto-props' option.
+# *.c = svn:eol-style=native
+# *.cpp = svn:eol-style=native
+# *.h = svn:eol-style=native
+# *.dsp = svn:eol-style=CRLF
+# *.dsw = svn:eol-style=CRLF
+# *.sh = svn:eol-style=native;svn:executable
+# *.txt = svn:eol-style=native
+# *.png = svn:mime-type=image/png
+# *.jpg = svn:mime-type=image/jpeg
+# Makefile = svn:eol-style=native
+
+
+# Add this stuff at bottom of your local file ~/.subversion/config
+#Note: for Windows this is normally found at
+# C:\Documents and Settings\{username}\Application Data\Subversion\config
+
+[miscellany]
+enable-auto-props = yes
+
+# Note: you may wish to add svn:keywords as well, depending on your project
requirements
+# E.g. svn:keywords=Date Author Id Revision HeadURL
+
+# Do not default any files to svn:executable=*.
+# This should only be done on an individual basis as required.
+
+[auto-props]
+INSTALL = svn:eol-style=native
+KEYS = svn:eol-style=native
+Makefile = svn:eol-style=native
+LICENSE = svn:eol-style=native
+NOTICE = svn:eol-style=native
+README = svn:eol-style=native
+abs-linkmap = svn:eol-style=native
+abs-menulinks = svn:eol-style=native
+*.aart = svn:eol-style=native
+*.ac = svn:eol-style=native
+*.am = svn:eol-style=native
+*.apt = svn:eol-style=native
+*.bat = svn:eol-style=native
+*.bsh = svn:eol-style=native
+*.c = svn:eol-style=native
+*.cat = svn:eol-style=native
+*.cgi = svn:eol-style=native
+*.classpath = svn:eol-style=native
+*.cmd = svn:eol-style=native
+*.cnd = svn:eol-style=native
+*.conf = svn:eol-style=native
+*.config = svn:eol-style=native
+*.cpp = svn:eol-style=native
+*.css = svn:eol-style=native
+*.cwiki = svn:eol-style=native
+*.data = svn:eol-style=native
+*.dcl = svn:eol-style=native
+*.doc = svn:mime-type=application/msword
+*.dsp = svn:eol-style=CRLF
+*.dsw = svn:eol-style=CRLF
+*.dtd = svn:eol-style=native
+*.egrm = svn:eol-style=native
+*.ent = svn:eol-style=native
+*.ft = svn:eol-style=native
+*.fn = svn:eol-style=native
+*.fv = svn:eol-style=native
+*.g = svn:eol-style=native
+*.gif = svn:mime-type=image/gif
+*.groovy = svn:eol-style=native svn:keywords="Id Author Date Rev"
svn:mime-type=text/plain
+*.grm = svn:eol-style=native
+*.gz = svn:mime-type=application/x-gzip
+*.h = svn:eol-style=native
+*.htc = svn:eol-style=native
+.htaccess = svn:eol-style=native
+*.handlers = svn:eol-style=native
+*.html = svn:eol-style=native
+*.ico = svn:mime-type=image/x-icon
+*.ihtml = svn:eol-style=native
+*.in = svn:eol-style=native
+*.java = svn:eol-style=native svn:keywords="Id Author Date Rev"
svn:mime-type=text/plain
+*.jmx = svn:eol-style=LF
+*.jpg = svn:mime-type=image/jpeg
+*.jsp = svn:eol-style=native
+*.js = svn:eol-style=native
+*.junit = svn:eol-style=native
+*.jx = svn:eol-style=native
+*.m = svn:eol-style=native
+*.m4 = svn:eol-style=native
+*.manifest = svn:eol-style=native
+*.mdo = svn:eol-style=native
+# markdown (CMS)
+*.mdtext = svn:eol-style=native
+*.meta = svn:eol-style=native
+*.mf = svn:eol-style=native
+*.MF = svn:eol-style=native
+*.mod = svn:eol-style=native
+*.ms = svn:eol-style=native
+*.n3 = svn:eol-style=native
+*.nroff = svn:eol-style=native
+*.patch = svn:eol-style=native
+*.pdf = svn:mime-type=application/pdf
+*.pen = svn:eol-style=native
+*.php = svn:eol-style=native
+*.pl = svn:eol-style=native
+*.pm = svn:eol-style=native
+*.png = svn:mime-type=image/png
+*.pod = svn:eol-style=native
+*.pom = svn:eol-style=native
+*.project = svn:eol-style=native
+*.properties = svn:eol-style=native
+*.py = svn:eol-style=native
+*.rb = svn:eol-style=native
+*.rdf = svn:eol-style=native
+*.rnc = svn:eol-style=native
+*.rng = svn:eol-style=native
+*.rnx = svn:eol-style=native
+*.roles = svn:eol-style=native
+*.rss = svn:eol-style=native
+# Restructured text (CMS)
+*.rst = svn:eol-style=native
+*.scala = svn:eol-style=native
+*.schemas = svn:eol-style=native
+*.sh = svn:eol-style=native
+*.sql = svn:eol-style=native
+*.svg = svn:eol-style=native
+*.tar = svn:mime-type=application/octet-stream
+*.tgz = svn:mime-type=application/octet-stream
+*.tif = svn:mime-type=image/tiff
+*.tiff = svn:mime-type=image/tiff
+*.tld = svn:eol-style=native
+*.txt = svn:eol-style=native
+*.types = svn:eol-style=native
+*.vm = svn:eol-style=native
+*.vsl = svn:eol-style=native
+*.wsdd = svn:eol-style=native
+*.wsdl = svn:eol-style=native
+*.xargs = svn:eol-style=native
+*.xcat = svn:eol-style=native
+*.xconf = svn:eol-style=native
+*.xegrm = svn:eol-style=native
+*.xgrm = svn:eol-style=native
+*.xhtml = svn:eol-style=native
+*.xhtml2 = svn:eol-style=native
+*.xlex = svn:eol-style=native
+*.xlog = svn:eol-style=native
+*.xmap = svn:eol-style=native
+*.xml = svn:eol-style=native
+*.xroles = svn:eol-style=native
+*.xsamples = svn:eol-style=native
+*.xsd = svn:eol-style=native
+*.xsl = svn:eol-style=native
+*.xslt = svn:eol-style=native
+*.xsp = svn:eol-style=native
+*.xtest = svn:eol-style=native
+*.xul = svn:eol-style=native
+*.xweb = svn:eol-style=native
+*.xwelcome = svn:eol-style=native
Modified: incubator/kitty/site/trunk/content/kitty/gettingstarted.mdtext
URL:
http://svn.apache.org/viewvc/incubator/kitty/site/trunk/content/kitty/gettingstarted.mdtext?rev=1058316&r1=1058315&r2=1058316&view=diff
==============================================================================
--- incubator/kitty/site/trunk/content/kitty/gettingstarted.mdtext (original)
+++ incubator/kitty/site/trunk/content/kitty/gettingstarted.mdtext Wed Jan 12
21:04:54 2011
@@ -16,6 +16,7 @@ Notice: Licensed to the Apache Softwa
specific language governing permissions and limitations
under the License.
+
Kitty is a command line JMX Client written in Groovy.
Kitty is currently an Apache Incubator project, and is growing as a JMX
administration utility for applications which support JMX. Kitty is an
excellent project to begin contributing to an open source project, and filing a
need amongst Java developers for a handy utility for managing and monitoring
applications through JMX in a way that is intuitive and user friendly.
<br />
@@ -30,30 +31,37 @@ There are many things to be worked on fo
<br />
If you are interested in being a committer for the project, see
http://www.apache.org/dev/new-committers-guide.html.
<br />
-Also, you may investigate the open issues for Kitty in the ASF JIRA to find
out which tasks and bugs need to be worked on. This is also a great starting
point for getting involved and contributing to the project.
https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12311202&status=1
+Also, you may investigate the open issues for Kitty in the ASF JIRA to find
out which tasks and bugs need to be worked on. This is also a great starting
point for getting involved and contributing to the project: <a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12311202&status=1";>Kitty
JIRA</a>
<br /><br />
<h3>Setting up your IDE</h3>
<br /><br />
It is suggested to download the Eclipse IDE to begin working on Kitty. This
allows you to keep better track of the source code of the project and
integrates with Subversion. You may use any editor or IDE you choose, in this
example, Eclipse is used.
<br />
-Step 1) Download Eclipse from http://www.eclipse.org/downloads/. I have chosen
the "Eclipse IDE for Java Developers"
-Step 2) Install the Subversive Plugin for Subversion integration by following
the instructions at
http://www.eclipse.org/subversive/documentation/gettingStarted/aboutSubversive/install.php
+Step 1) Download Eclipse from <a
href="http://www.eclipse.org/downloads/";>http://www.eclipse.org/downloads/</a>
. I have chosen the "Eclipse IDE for Java Developers"
+Step 2) Install the Subversive Plugin for Subversion integration by following
the instructions at <a
href="http://www.eclipse.org/subversive/documentation/gettingStarted/aboutSubversive/install.php>http://www.eclipse.org/subversive/documentation/gettingStarted/aboutSubversive/install.php</a>
<br />
NOTE: You should now see a "SVN Repositories" button on the top right view, or
by navigating to Window->Show View->SVN Repositories
-<br />
-NOTE: You will need to change the update site for the Subversive connectors,
if you don't do this it is likely that the connector installation will fail.
You should use
http://download.eclipse.org/technology/subversive/0.7/update-site/ fro the
connectors update site. See http://www.eclipse.org/subversive/downloads.php "Is
it right that version 0.7 is newer than versions 1.1.0 and 1.0.0, which I
previously used?" in the FAQs for a further explanation. If you run into
trouble here, send a message to the mailing list and someone will help you.
+<br /><br />
-Step 3) Append or use the following .subversion/config file to properly set
your Subversion configuration for ASF/Kitty use.
+NOTE: You will need to change the update site for the Subversive connectors,
if you don't do this it is likely that the connector installation will fail.
You should use
http://download.eclipse.org/technology/subversive/0.7/update-site/ for the
connectors update site. See <a
href="http://www.eclipse.org/subversive/downloads.php";>http://www.eclipse.org/subversive/downloads.php</a>
"Is it right that version 0.7 is newer than versions 1.1.0 and 1.0.0, which I
previously used?" in the FAQs for a further explanation. If you run into
trouble here, send a message to the mailing list and someone will help you.
-Step 4) Download Groovy from http://groovy.codehaus.org/Download
-Step 5) Install the Groovy-Eclipse plugin by following the instructions at
http://groovy.codehaus.org/Eclipse+Plugin under "How to Install"
+Step 3) Append or use the following <a
href="files/config">.subversion/config</a> file to properly set your Subversion
configuration for ASF/Kitty use.
+
+Step 4) Download Groovy from <a href="http://groovy.codehaus.org/Download";>
http://groovy.codehaus.org/Download</a>
+Step 5) Install the Groovy-Eclipse plugin by following the instructions at <a
href="http://groovy.codehaus.org/Eclipse+Plugin";>http://groovy.codehaus.org/Eclipse+Plugin</a>
under "How to Install"
Step 6) Navigate to SVN Repositories by clicking the SVN Repositories button
in the top right-hand corner or by going to the menu: "Window->Show View->SVN
Repositories"
-Step 7) Click the menu: "New->Repository Location"
-Step 8) Enter https://svn.apache.org/repos/asf/incubator/kitty/ for the URL.
Leave all other fields blank, unless you are a commuter.
-<br />
-NOTE: Unless you are a committer, you will be unable to commit changes through
SVN. If you'd like to be a committer, send a message out to the
[email protected] mailing list, our simply attach a patch to the
mailing list and one of the committers will check it in. For guidelines on
submitting a patch: see
http://subversion.apache.org/docs/community-guide/general.html#patches.
+Step 7) Click the menu: "New->Repository Location"<br />
+<img src="images/subversion-new-repo-location.png" alt="Subversive New Repo"
/> <br /> <br />
+
+
+Step 8) Enter https://svn.apache.org/repos/asf/incubator/kitty/ for the URL.
Leave all other fields blank, unless you are a committer. <br />
+
+<img src="images/subversion-new-repo-location-url.png" alt="Subversive New
Repo" /> <br /> <br />
+
+
+NOTE: Unless you are a committer, you will be unable to commit changes through
SVN. If you'd like to be a committer, send a message out to the
[email protected] mailing list, our simply attach a patch to the
mailing list and one of the committers will check it in. For guidelines on
submitting a patch: see <a
href="http://subversion.apache.org/docs/community-guide/general.html#patches";>http://subversion.apache.org/docs/community-guide/general.html#patches</a>.
<br />
Now you will have set up your development environment for working with Kitty.
You will now need to set up and configure Apache Ant to build the project.
<br /><br />
@@ -77,6 +85,7 @@ Step 1) Navigate to src/org/apache/kitty
Step 2) Right click on CmdShell.groovy
Step 3) Select "Run As->Groovy script"
<br /><br />
+<img src="images/apache-kitty-eclipse-console.png" alt="Kitty Groovy Eclipse
Console" />
Now you will see Kitty running in the Eclipse Console. Type help to see a list
of available commands. Now you may use and test Kitty!
@@ -85,4 +94,5 @@ NOTE: This document is continuously bein
<br /><br />
+
<a href="http://incubator.apache.org/kitty/";>Kitty Home</a>
\ No newline at end of file
Added:
incubator/kitty/site/trunk/content/kitty/images/apache-kitty-eclipse-console.png
URL:
http://svn.apache.org/viewvc/incubator/kitty/site/trunk/content/kitty/images/apache-kitty-eclipse-console.png?rev=1058316&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
incubator/kitty/site/trunk/content/kitty/images/apache-kitty-eclipse-console.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added:
incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location-url.png
URL:
http://svn.apache.org/viewvc/incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location-url.png?rev=1058316&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location-url.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added:
incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location.png
URL:
http://svn.apache.org/viewvc/incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location.png?rev=1058316&view=auto
==============================================================================
Binary file - no diff available.
Propchange:
incubator/kitty/site/trunk/content/kitty/images/subversive-new-repo-location.png
------------------------------------------------------------------------------
svn:mime-type = image/png
