#1954: 'make docs' target: Why are these files not installed?
---------------------+------------------------------------------------------
Reporter: jkeenan | Owner: whiteknight
Type: bug | Status: new
Priority: minor | Milestone:
Component: docs | Version: 2.11.0
Severity: low | Keywords:
Lang: | Patch:
Platform: |
---------------------+------------------------------------------------------
Comment(by jkeenan):
Further investigation shows that POD for the ops listed in the `make docs`
part of the Description is indeed installed along with all other POD:
{{{
ls -lS /tmp/pseudoinstall/share/doc/parrot/2.11.0-devel/pod/ops/
total 68
-rw-r--r-- 1 jimk jimk 13516 Jan 8 19:27 core.pod
-rw-r--r-- 1 jimk jimk 8263 Jan 8 19:27 string.pod
-rw-r--r-- 1 jimk jimk 7886 Jan 8 19:27 cmp.pod
-rw-r--r-- 1 jimk jimk 6040 Jan 8 19:27 pmc.pod
-rw-r--r-- 1 jimk jimk 5511 Jan 8 19:27 math.pod
-rw-r--r-- 1 jimk jimk 5389 Jan 8 19:27 var.pod
-rw-r--r-- 1 jimk jimk 4615 Jan 8 19:27 object.pod
-rw-r--r-- 1 jimk jimk 3678 Jan 8 19:27 set.pod
-rw-r--r-- 1 jimk jimk 2064 Jan 8 19:27 experimental.pod
-rw-r--r-- 1 jimk jimk 1780 Jan 8 19:27 bit.pod
-rw-r--r-- 1 jimk jimk 1754 Jan 8 19:27 sys.pod
-rw-r--r-- 1 jimk jimk 1046 Jan 8 19:27 io.pod
}}}
versus
{{{
$ ls -lS docs/ops/
total 68
-rw-r--r-- 1 jimk jimk 13516 Jan 11 21:56 core.pod
-rw-r--r-- 1 jimk jimk 8263 Jan 11 21:56 string.pod
-rw-r--r-- 1 jimk jimk 7886 Jan 11 21:56 cmp.pod
-rw-r--r-- 1 jimk jimk 6040 Jan 11 21:56 pmc.pod
-rw-r--r-- 1 jimk jimk 5511 Jan 11 21:56 math.pod
-rw-r--r-- 1 jimk jimk 5389 Jan 11 21:56 var.pod
-rw-r--r-- 1 jimk jimk 4615 Jan 11 21:56 object.pod
-rw-r--r-- 1 jimk jimk 3678 Jan 11 21:56 set.pod
-rw-r--r-- 1 jimk jimk 2064 Jan 11 21:56 experimental.pod
-rw-r--r-- 1 jimk jimk 1780 Jan 11 21:56 bit.pod
-rw-r--r-- 1 jimk jimk 1754 Jan 11 21:56 sys.pod
-rw-r--r-- 1 jimk jimk 1046 Jan 11 21:56 io.pod
}}}
So my guess is that `make docs` is a vestige of some early, vintage-2003
documentation schema. That suggests that the `all` part of the docs
Makefile -- generated from ''config/gen/makefiles/docs.in'' and earlier
still from ''config/auto/perldoc.pm'' is entirely superfluous.
Does that analysis seem correct?
kid51
--
Ticket URL: <https://trac.parrot.org/parrot/ticket/1954#comment:1>
Parrot <https://trac.parrot.org/parrot/>
Parrot Development
_______________________________________________
parrot-tickets mailing list
[email protected]
http://lists.parrot.org/mailman/listinfo/parrot-tickets
