The hasktags package

[Tags: bsd3, library, program]

Produces ctags tags and etags TAGS files for Haskell programs.


[Skip to ReadMe]

Properties

Versions0.67, 0.68, 0.68.1, 0.68.2, 0.68.3, 0.68.4, 0.68.5, 0.68.6, 0.68.7, 0.69.0, 0.69.1 (info)
Change logNone available
Dependenciesbase (==4.*), bytestring (>=0.9 && <0.11), directory (>=1.1 && <1.3), filepath, HUnit (==1.2.*), interlude, json (>=0.5 && <0.8), unix [details]
LicenseBSD3
CopyrightThe University Court of the University of Glasgow
AuthorThe GHC Team
MaintainerMarc Weber <marco-oweber@gmx.de>, Marco Túlio Pimenta Gontijo <marcotmarcot@gmail.com>
CategoryDevelopment
Home pagehttp://github.com/MarcWeber/hasktags
Bug trackerhttp://github.com/MarcWeber/hasktags/issues
Source repositoryhead: git clone http://github.com/MarcWeber/hasktags
Executablestest, hasktags
UploadedThu Jan 16 12:51:22 UTC 2014 by MarcWeber
DistributionsDebian:0.69.1, FreeBSD:0.69.1, NixOS:0.69.1
Downloads8585 total (404 in last 30 days)
Votes
0 []
StatusDocs not available [build log]
All reported builds failed as of 2015-05-30 [all 2 reports]

Flags

NameDescriptionDefaultType
debugWhen set to true tokens will be print at various places. This helps understanding why hasktags does not behave the w ay it shouldDisabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for hasktags-0.68.5

hasktags: a tool to generate tag files for vim and emacs

  What is it for? A tag file is a index containing key items of your project such as
  - function names
  - module names
  - data declarations
  - ...

  so that you can find / jump to them fast.

HOWTO (GENERATING TAG FILES):
  Build hasktags (standard cabal build)

  I've been using this bash function or something similar for a long time.
  It may be cumbersome but works:

  runHaskTagsVim() {
          # use --etags instead of --ctags for emacs
          hasktags --ignore-close-implementation --ctags .; sort tags
  }

HOWTO (USING TAG FILES):
  VIM: let tags+=tagifle " tags,TAGS is the default setting so probably you don't have to do anything
       :tjump foo<tab> or such. See :h tags
  
  NEdit:
	Load the "tags" file using File/Load Tags File.
	Use "Ctrl-D" to search for a tag.

  XEmacs/Emacs:
	Load the "TAGS" file using "visit-tags-table"
	Use "M-." to search for a tag.

  jedit:
        There is a plugin
	


run test cases:
  cd testcases; sh test.sh


history:
In the past this tool was distributed with ghc. I forked and added some
features.  hasktags itself was moved out of the ghc repository. Then I only
verified that my fork finds at least as much tags as the one forked by Igloo.

Things which could be done in the future:
- make json support optional
- Marco Túlio Pimenta Gontijo proposed replacing json by aeson because it might
  be faster
- write a nice README.md file instead

maintainers: See cabal file


comments about literate haskell (lhs):
=======================================
http://www.haskell.org/haskellwiki/Literate_programming
alex no longer supports bird style ">", so should we drop support, too?

contributors:
  Tsuru Capital (github/liyang)
  Marco Túlio Pimenta Gontijo (github/marcotmarcot)
  TODO: add all people having contributed before Oct 2012
  This includes people contributing to the darcs repository as well as people
  having contributed when this repository has been part of ghc

related work (list taken from announce of lushtags:
  https://github.com/bitc/lushtags
  http://hackage.haskell.org/package/hasktags
  http://kingfisher.nfshost.com/sw/gasbag/
  http://hackage.haskell.org/package/hothasktags
  http://majutsushi.github.com/tagbar/
and probably much more