Menu
▾
▴
[ jEdit-devel ] [ jedit-Plugin Central Submission-3132150 ] ClassBrowser 1.4
|
From: SourceForge.net <no...@so...> - 2010-12-21 19:27:38
|
Plugin Central Submission item #3132150, was opened at 2010-12-08 00:08 Message generated for change (Comment added) made by elberry You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=625093&aid=3132150&group_id=588 Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: None Group: None >Status: Pending Priority: 5 Private: No Submitted By: Shlomy Reinstein (shlomy) >Assigned to: Townsfolk (elberry) Summary: ClassBrowser 1.4 Initial Comment: Paste the text below into the Plugin Central Submission Tracker at https://sourceforge.net/tracker/?group_id=588&atid=625093 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ {{{ ClassBrowser 1.4 Source: Source code is in Git with the tag release-1.4 Announcement: A new version which depends on the Lucene-based CtagsInterface Requires Java 1.5 Requires jEdit 04.04.01.00 Required plugins: ctagsinterface.main.CtagsInterfacePlugin 2.1 Short Description: The ClassBrowser plugin provides a dockable window presenting the hierarchy of a selected class, along with its members (including inherited members, if requested). You can jump to each element (class/member) in the hierarchy by double-clicking it. The hierarchy is generated using information from Ctags tag files. Long Description: <html> <title>ClassBrowser plugin</title> <body> <h1>The ClassBrowser plugin</h1> Written by Shlomy Reinstein, January 2007. <h2>Table of Contents</h2> <ol> <li><a href="#introduction">Introduction</a> <li><a href="#description">Description</a> <li><a href="#requirements">Requirements</a> <li><a href="#usage">Usage</a> <li><a href="#notes">Notes</a> <li><a href="#feedback">Feedback</a> </ol> <a name="introduction"> <h2>Introduction</h2> </a> The ClassBrowser plugin provides a dockable window presenting the hierarchy of a selected class, along with its members (including inherited members, if requested). You can jump to each element (class/member) in the hierarchy by double-clicking it. The hierarchy is generated using information provided by the Ctags tool. <a name="description"> <h2>Description</h2> </a> The dockable window of ClassBrowser contains a split pane, presenting the class hierarchy in the upper part and the members of the currently-selected class (within the hierarchy) in the lower part. Double-clicking a member or a class jumps to the definition of that class or member. <h3>The class hierarchy pane</h3> The class hierarchy is presented as a tree. Three separate hierarchies can be displayed: <ul> <li>The complete class hierarchy: Presents all the base (super) classes as well as all the derived (sub) classes, and is available only when the hierarchy has a single root, i.e. there is no multiple inheritance from the selected class towards the root. <li>The base (super) class hierarchy: Presents all the classes from which the selected class is derived. Here, the selected class is at the root of the tree, and each class node has its direct base classes as children. <li>The derived (sub) class hierarchy: Presents all the classes that are derived from the selected class. The selected class is at the root of the tree, and each class node has its direct descendants as children. </ul> You can toggle between the hierarchies using buttons above the hierarchy. When the complete class hierarchy is not available, the button to select it is hidden. <h3>The class members pane</h3> The members of the class that is currently selected in the hierarchy pane are displayed in the lower part of the split pane (the members pane). Two views are available: <ul> <li>Self members: Lists all the members defined in the selected class. <li>Inherited: Lists all the members defined in the selected class, as well as the members inherited from its base (super) classses. In this view, the name of the defining class is appended to each member, so you know where each member comes from. </ul> You can toggle between the views using buttons above the members pane. In addition, the members pane contains buttons for hiding members having specific attributes: <ul> <li> <b>F</b>: Hides fields (data members) <li> <b>S</b>: Hides static members (both data and function members) <li> <b>NP</b>: Hides non-public members (both data and function members) </ul> <a name="requirements"> <h2>Requirements</h2> </a> <h3>CtagsInterface plugin</h3> ClassBrowser uses the CtagsInterface plugin to provide it with the tag information. It also uses CtagsInterface to jump to selected tags (classes/members). Hence, you must have CtagsInterface installed and configured properly. <h3>Ctags invocation</h3> To make the best use of ClassBrowser, configure the CtagsInterface plugin to provide the following options to Ctags: <code>--fields=+anzKiS</code> <br> These options tell Ctags to generate inheritance information, function/method signatures, access of class members (public/private/...), and provide complete names for tag kinds. <a name="usage"> <h2>Usage</h2> </a> To use ClassBrowser, do one of the following: <ul> <li> Select the name of a class in a jEdit buffer, and invoke "Plugins -> Class Browser -> Show Class Hierarchy" <li> Invoke "Plugins -> Class Browser -> Show Class Hierarchy .." and enter the name of the class in the input dialog that opens. </ul> Generating the hierarchy may take a while, depending on the sizes of the hierarchy and the tag database. Wait patiently, and you will get the hierarchy in a "Class Hierarchy Browser" dockable. <a name="notes"> <h2>Notes</h2> </a> <ul> <li> The support for classes within a scope (e.g. classes under a namespace in C++, inner classes in Java) is quite limited in this version. Due to the information generated by Ctags, such classes can never be accurately supported, but future versions of the plugin will attempt to better handle scoped classes. For now, if you want to see the upper part of the hierarchy of a scoped class (i.e. the tree of 'super' or 'base' classes, search for the plain class name (i.e. without the namespace/outer class name). If you want to see the lower part of the hierarchy (i.e. the 'sub' or 'derived' classes), use the qualified class name. </ul> <a name="feedback"> <h2>Feedback</h2> </a> Any feedback would be most welcome. Please send your feedback to the jedit-users or jedit-devel mailing list. </body> </html> }}} ---------------------------------------------------------------------- >Comment By: Townsfolk (elberry) Date: 2010-12-21 11:27 Message: Shlomy, can you please make your build.xml look like this: [quote] <?xml version="1.0"?> <project name="ClassBrowser" default="dist" basedir="."> <property file="build.properties"/> <property file="../build.properties"/> <property file="${user.home}/.build.properties"/> <property file="${user.home}/build.properties"/> <property name="dist.target" value="build" /> <property name="jedit.plugins.dir" value="${install.dir}" /> <import file="${build.support}/plugin-build.xml" /> <selector id="packageFiles"> <filename name="description.html" /> </selector> <path id="project.class.path"> <pathelement location="${jedit.install.dir}/jedit.jar"/> <pathelement location="${src.dir}"/> <pathelement location="${jedit.plugins.dir}/CtagsInterface.jar"/> </path> </project> [/quote] I've added a property setting for jedit.plugins.dir on line 10, and changed your project.class.path to use it instead of your ${user.home} directory. I have no desire to figure out patches or how to deal with Git branches, or tags for this. Please make the desired changes and retag, then reopen. ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=625093&aid=3132150&group_id=588 |