#1679: examples/compilers/japhc.c: Misleading documentation
---------------------+------------------------------------------------------
Reporter: jkeenan | Owner:
Type: bug | Status: new
Priority: normal | Milestone:
Component: docs | Version: 2.4.0
Severity: medium | Keywords:
Lang: | Patch:
Platform: |
---------------------+------------------------------------------------------
=head1 NAME
examples/compiler/japhc.c
My attention was drawn to this file because, during my work in the
''cfunctiondocs'' branch, it showed up as one of the last documents still
failing ''t/codingstd/c_function_docs.t''. Here is the start of this
file's POD:
{{{
=head1 DESCRIPTION
example compiler used by japh16.pasm
=head1 SYNOPSIS
$ make -C examples/compilers/
$ parrot examples/japh/japh16.pasm
}}}
Problem: There is no such file as ''examples/japh/japh16.pasm''. In the
course of testing we apparently create these files:
{{{
t/examples/japh_1.pasm
t/examples/japh_3.pasm
t/examples/japh_4.pasm
t/examples/japh_5.pasm
}}}
... but no japh_16 or japh16 (and where did japh_2.pasm go?).
Can anyone clarify? (The code is several years old. I'm going to CC
anyone who has touched it in recent years.)
Thank you very much.
kid51
--
Ticket URL: <https://trac.parrot.org/parrot/ticket/1679>
Parrot <https://trac.parrot.org/parrot/>
Parrot Development
_______________________________________________
parrot-tickets mailing list
[email protected]
http://lists.parrot.org/mailman/listinfo/parrot-tickets
