Skip to content

Latest commit

 

History

History
49 lines (28 loc) · 1.8 KB

README.md

File metadata and controls

49 lines (28 loc) · 1.8 KB

localgrok

A package of OpenGrok with Jetty and a simple interface, usable as a standalone desktop application. Based on OpenGrok 0.10 and Jetty 8.0.

First of all

This is my first (and to date last) Java project. If you think that it's ugly... well, that's because it is. I wrote it a few years ago because there seemed to be no decent code browsing tool for Linux at that time. And settion up OpenGrok is too much hassle for a developer.

I consider it unstable. It runs, all 3 buttons work, it indexes, and the web page opens. Other than that I've done no testing.

Prerequisites

  • Java <= 1.7 (patches for 1.8 are welcome!)

  • ctags

    OpenGrok needs Exuberant Ctags.

    Linux: ctags should be in the repositories of all major distributions.

    Windows: Donwload the Windows build and place ctags.exe somewhere in PATH.

Installation

None needed. Just clone the repository and double-click localgrock.jar. Run it from command line like java -jar localgrok.jar to get a kind of verbose output.

Usage

Simply choose the directory and click Reindex. After indexing has finished, click on the progress bar to open the OpenGrok web interface.

LocalGrok is configured to enable the Projects feature of OpenGrok. Basically, you put all the code that you want to index in a single place, like this:

.
├── work
    ├── src
        ├── my_project
        ├── my_better_project
        └── my best project

Then simply point LocalGrok to .../work/src and have your stuff neatly organized.