#677: Which tools/*/*.pl programs belong in which tools/* directory?
-----------------------+----------------------------------------------------
Reporter: jkeenan | Owner:
Type: cage | Status: new
Priority: minor | Milestone:
Component: configure | Version: 1.1.0
Severity: low | Keywords: tools
Lang: | Patch:
Platform: |
-----------------------+----------------------------------------------------
Comment(by wayland):
Here's some suggested documentation until we have something better:
-----
The tools/ directory was begun as an ad-hoc collection of random files.
This guideline suggests what kind of files go where. It is hoped that,
over time, the files will migrate to the places suggested in this
guideline. If you really want to put a file somewhere where this
guideline doesn't suggest, then that probably means that this guideline
needs updating.
build Tools called by the build process
dev Tools that are called on a one-off, ad-hoc basis by developers
docs Tools that help generate the documentation from source
install Not sure about these; they're probably good for something
util No rule appears to govern these either; maybe they should be
merged with "dev"
-----
It seems to me that a number of the scripts can probably be turfed out now
that we don't have all the languages stored with Parrot. In particular,
it seems that tools/install/smoke_languages.pl can go, which means that
the install directory contains only the one file. That seems to me to
mean that that file should go somewhere else, and the install directory
deleted.
--
Ticket URL: <https://trac.parrot.org/parrot/ticket/677#comment:5>
Parrot <https://trac.parrot.org/parrot/>
Parrot Development
_______________________________________________
parrot-tickets mailing list
[email protected]
http://lists.parrot.org/mailman/listinfo/parrot-tickets
