#1922: Review Parrot's 'make help'
---------------------+------------------------------------------------------
Reporter: jkeenan | Owner: jkeenan
Type: cage | Status: assigned
Priority: normal | Milestone:
Component: docs | Version: 2.10.0
Severity: low | Keywords:
Lang: | Patch:
Platform: |
---------------------+------------------------------------------------------
Comment(by cotto):
copy/pasting because I'm too lazy to be bothered to look at an attachment
1) make without arguments is supposed to build parrot and documentation,
but it also builds parrot_utils (except parrot-prove), so we may think
that all and world targets are the same. Maybe, we can remove parrot_utils
from make help or make 'world' the default target
2) Targets not listed in make help:
miniparrot
cagecritic
some pasm examples (cat,fact,trace) <-- add them to 'Examples'
parrot-prove, ops2c (in parrot_utils)
configure_tests <-- may be usable for Parrot devs
3)make archclean doesn't clean some *.o files, but object files are arch-
dependant, aren't they?
4)make 'distclean' and 'realclean' targets do the same thing.
5)make installable can be described better in make help
*6)circular dependencies:
docs-clean <-> clean
docs <-> docs-dummy
html <-> html-dummy
htmlhelp <-> htmlhelp-dummy
*7)html-clean,pdf depend on themselves
8)Fix 6),7) and add htmlhelp-clean and pdf-clean to docs-clean
*]Maybe, these are features, not bugs :). I've run configure.pl on Ubuntu
10.04 , Perl v5.10.1, perldoc --version reports "Perldoc v3.14_04, under
perl v5.010001 for linux"
--
Ticket URL: <https://trac.parrot.org/parrot/ticket/1922#comment:3>
Parrot <https://trac.parrot.org/parrot/>
Parrot Development
_______________________________________________
parrot-tickets mailing list
[email protected]
http://lists.parrot.org/mailman/listinfo/parrot-tickets
