Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

'Removed files from 'parrot.github.com'

  • Loading branch information...
commit 4e19c9a749c79812320626b1eca3572e4cdb0d3e 1 parent a235710
Alvis Yardley ayardley authored

Showing 453 changed files with 0 additions and 33,045 deletions. Show diff stats Hide diff stats

  1. +0 70 Makefile
  2. +0 24 README.pod
  3. +0 24 binaries/README.pod
  4. +0 54 binaries/ops2c.pod
  5. +0 80 binaries/parrot-nqp.pod
  6. +0 98 binaries/parrot-prove.pod
  7. +0 417 binaries/parrot.pod
  8. +0 36 binaries/parrot_config.pod
  9. +0 73 binaries/parrot_nci_thunk_gen.pod
  10. +0 95 binaries/parrotbug.pod
  11. +0 67 binaries/pbc_to_exe.pod
  12. +0 147 binaries/plumage.pod
  13. +0 40 binaries/winxed.pod
  14. +0 62 book/draft/README.pod
  15. +0 314 book/draft/appa_glossary.pod
  16. +0 138 book/draft/appb_patch_submission.pod
  17. +0 306 book/draft/appc_command_line_options.pod
  18. +0 93 book/draft/appd_build_options.pod
  19. +0 72 book/draft/appe_source_code.pod
  20. +0 215 book/draft/ch01_introduction.pod
  21. +0 182 book/draft/ch02_getting_started.pod
  22. +0 234 book/draft/ch07_dynpmcs.pod
  23. +0 259 book/draft/ch08_dynops.pod
  24. +0 2,915 book/draft/ch10_opcode_reference.pod
  25. +0 210 book/draft/ch11_directive_reference.pod
  26. +0 299 book/draft/ch12_operator_reference.pod
  27. +0 293 book/draft/chXX_hlls.pod
  28. +0 107 book/draft/chXX_library.pod
  29. +0 128 book/draft/chXX_testing_and_debugging.pod
  30. +0 215 book/pct/ch01_introduction.pod
  31. +0 182 book/pct/ch02_getting_started.pod
  32. +0 333 book/pct/ch03_compiler_tools.pod
  33. +0 1,567 book/pct/ch04_pge.pod
  34. +0 221 book/pct/ch05_nqp.pod
  35. +0 113 book/pir/ch01_introduction.pod
  36. +0 78 book/pir/ch02_getting_started.pod
  37. +0 314 book/pir/ch03_basic_syntax.pod
  38. +0 1,834 book/pir/ch04_variables.pod
  39. +0 343 book/pir/ch05_control_structures.pod
  40. +0 1,300 book/pir/ch06_subroutines.pod
  41. +0 497 book/pir/ch07_objects.pod
  42. +0 411 book/pir/ch08_io.pod
  43. +0 397 book/pir/ch09_exceptions.pod
  44. +0 772 compiler_faq.pod
  45. +0 304 configuration.pod
  46. +0 242 debug.pod
  47. +0 399 debugger.pod
  48. +0 231 deprecations/deprecations.pod
  49. +0 73 deprecations/deprecations_2_6.pod
  50. +0 200 deprecations/deprecations_2_9.pod
  51. +0 222 deprecations/deprecations_3_0.pod
  52. +0 28 deprecations/deprecations_3_3.pod
  53. +0 59 deprecations/deprecations_3_6.pod
  54. +0 136 deprecations/how_to_deprecate.pod
  55. +0 153 dev/byteorder.pod
  56. +0 228 dev/c_functions.pod
  57. +0 61 dev/coverage.pod
  58. +0 126 dev/debugging_with_msvc.pod
  59. +0 118 dev/events.pod
  60. +0 40 dev/headerizer.pod
  61. +0 316 dev/infant.pod
  62. +0 66 dev/longopt.pod
  63. +0 181 dev/optimizer.pod
  64. +0 39 dev/parrot_api.pod
  65. +0 133 dev/pcc_methods.pod
  66. +0 102 dev/pcc_state.pod
  67. +0 236 dev/pmc_freeze.pod
  68. +0 239 dev/pmc_obj_design_meeting_notes.pod
  69. +0 130 dev/profiling.pod
  70. +0 1,619 embed.pod
  71. +0 336 embed_new.pod
  72. +0 42 extend.pod
  73. +0 82 faq.pod
  74. +0 197 gettingstarted.pod
  75. +0 321 glossary.pod
  76. +0 76 html/DONORS.pod.html
  77. +0 52 html/book.html
  78. +0 101 html/developer.html
  79. +0 186 html/docs/book/draft/appa_glossary.pod.html
  80. +0 136 html/docs/book/draft/appb_patch_submission.pod.html
  81. +0 161 html/docs/book/draft/appc_command_line_options.pod.html
  82. +0 108 html/docs/book/draft/appd_build_options.pod.html
  83. +0 74 html/docs/book/draft/appe_source_code.pod.html
  84. +0 254 html/docs/book/draft/ch01_introduction.pod.html
  85. +0 158 html/docs/book/draft/ch02_getting_started.pod.html
  86. +0 226 html/docs/book/draft/ch07_dynpmcs.pod.html
  87. +0 248 html/docs/book/draft/ch08_dynops.pod.html
  88. +0 3,274 html/docs/book/draft/ch10_opcode_reference.pod.html
  89. +0 304 html/docs/book/draft/ch11_directive_reference.pod.html
  90. +0 420 html/docs/book/draft/ch12_operator_reference.pod.html
  91. +0 325 html/docs/book/draft/chXX_hlls.pod.html
  92. +0 138 html/docs/book/draft/chXX_library.pod.html
  93. +0 131 html/docs/book/draft/chXX_testing_and_debugging.pod.html
  94. +0 254 html/docs/book/pct/ch01_introduction.pod.html
  95. +0 158 html/docs/book/pct/ch02_getting_started.pod.html
  96. +0 346 html/docs/book/pct/ch03_compiler_tools.pod.html
  97. +0 645 html/docs/book/pct/ch04_pge.pod.html
  98. +0 230 html/docs/book/pct/ch05_nqp.pod.html
  99. +0 160 html/docs/book/pir/ch01_introduction.pod.html
  100. +0 91 html/docs/book/pir/ch02_getting_started.pod.html
  101. +0 220 html/docs/book/pir/ch03_basic_syntax.pod.html
  102. +0 1,182 html/docs/book/pir/ch04_variables.pod.html
  103. +0 306 html/docs/book/pir/ch05_control_structures.pod.html
  104. +0 793 html/docs/book/pir/ch06_subroutines.pod.html
Sorry, we could not display the entire diff because too many files (453) changed.
70 Makefile
... ... @@ -1,70 +0,0 @@
1   -# ex: set ro:
2   -# DO NOT EDIT THIS FILE
3   -# Generated by Parrot::Configure::Compiler from config/gen/makefiles/docs.in
4   -
5   -# Copyright (C) 2001-2010, Parrot Foundation.
6   -
7   -# Setup of some commands
8   -PERL = /usr/bin/perl
9   -CHMOD = $(PERL) -MExtUtils::Command -e chmod
10   -MKPATH = $(PERL) -MExtUtils::Command -e mkpath
11   -TOUCH = $(PERL) -MExtUtils::Command -e touch
12   -RM_F = $(PERL) -MExtUtils::Command -e rm_f
13   -RM_RF = $(PERL) -MExtUtils::Command -e rm_rf
14   -PERLDOC_BIN = /usr/bin/perldoc
15   -VERSION = 4.4.0-devel
16   -
17   -#
18   -# Targets
19   -#
20   -# This is a listing of all targets, that are meant to be called by users
21   -# Most of them are proxied in the root makefile parrot/Makefile
22   -help :
23   - @echo ""
24   - @echo "Following targets are available:"
25   - @echo ""
26   - @echo "help Generate this usage statement."
27   - @echo " This is the default target."
28   - @echo ""
29   - @echo "html Generate html documentation"
30   - @echo "html-clean Remove html documentation"
31   - @echo ""
32   - @echo "htmlhelp: windows only, generate a .chm file."
33   - @echo "htmlhelp-clean: Remove generated .chm"
34   - @echo ""
35   - @echo "pdf: Generate a PDF from the html docs"
36   - @echo "pdf-clean: Remove generated pdf"
37   - @echo ""
38   - @echo " clean: Invoke all clean targets"
39   - @echo ""
40   -
41   -clean: htmlhelp-clean html-clean
42   -
43   -html:
44   - $(PERL) -I../lib ../tools/docs/mk_html_docs.pl --version=$(VERSION)
45   -html-clean:
46   - $(RM_RF) html
47   -
48   -# If you are missing the command 'pdflatex' then you have first to install a
49   -# LaTeX distribution with it. For Windows and UNIX downloads are for example
50   -# available from: http://miktex.org, http://tug.org/texlive or
51   -# http://www.ctan.org
52   -pdf: ../tools/docs/filename_and_chapter.pl
53   - $(MKPATH) build/modified_pod
54   - $(PERL) ../tools/docs/filename_and_chapter.pl
55   - cd build && pdflatex parrot-book.tex && pdflatex parrot-book.tex
56   -
57   -#pdf-release: build/parrot-book.pdf
58   -# cp build/parrot-book.pdf build/parrot-book-$$(date +"%Y.%m").pdf
59   -
60   -pdf-clean:
61   - $(RM_RF) build
62   -
63   -htmlhelp: html
64   -
65   -htmlhelp-clean:
66   -
67   -# Local variables:
68   -# mode: makefile
69   -# End:
70   -# vim: ft=make:
24 README.pod
Source Rendered
... ... @@ -1,24 +0,0 @@
1   -# Copyright (C) 2001-2012, Parrot Foundation.
2   -
3   -=pod
4   -
5   -=head1 NAME
6   -
7   -README - Readme file for the conversion of 'docs.parrot.org' to github pages.
8   -
9   -=head1 DESCRIPTION
10   -
11   -This README sets out the reason for the relocation of Parrot's documentation,
12   -which ordinarily resides on 'docs.parrot.org', to [Github pages]
13   -(http://pages.github.com). The basic idea is to make editing of the
14   -documentation more readily accessible. That is, with these pages now up on
15   -github, folks can more easily fix or, alternatively, provide pull requests to
16   -correct any errors in the documentation.
17   -
18   -So, everyone, feel free to contribute!
19   -
20   -=head1 COPYRIGHT
21   -
22   -Copyright (C) 2012, Parrot Foundation.
23   -
24   -=cut
24 binaries/README.pod
Source Rendered
... ... @@ -1,24 +0,0 @@
1   -# Copyright (C) 2001-2012, Parrot Foundation.
2   -
3   -=pod
4   -
5   -=head1 NAME
6   -
7   -docs/binaries/README.pod - Readme file for the 'docs/binaries/' directory.
8   -
9   -=head1 DESCRIPTION
10   -
11   -This directory contains the *.pod files to the installable binaries in the
12   -Parrot distribution. These files are also (or soon will be) used to generate
13   -*roff pages.[1]
14   -
15   -=head1 NOTES
16   -
17   -[1] The probable location and name of the conversion script will be,
18   -F<tools/docs/mk_pod2man.pl>
19   -
20   -=head1 COPYRIGHT
21   -
22   -Copyright (C) 2012, Parrot Foundation.
23   -
24   -=cut
54 binaries/ops2c.pod
Source Rendered
... ... @@ -1,54 +0,0 @@
1   -# Copyright (C) 2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -ops2c - Convert Parrot opcodes to C
6   -
7   -=head1 Description
8   -
9   -Translate Parrot opcode files (.ops) to C files.
10   -
11   -=head1 Usage
12   -
13   -ops2c [option]
14   -
15   -=head2 Command line Options
16   -
17   -For help, use :
18   -
19   - -h
20   - --help
21   -
22   -To generate the C code for core ops (must be run from within Parrot's build directory), use :
23   -
24   - -c
25   - --core
26   -
27   -To generate the C code for dynamic ops in a single .ops file, use :
28   -
29   - -d <file.ops>
30   - --dynamic <file.ops>
31   -
32   -To suppress error messages, use :
33   -
34   - -q
35   - --quiet
36   -
37   -To suppress #line directives in generated C code (line numbers are not currently supported), use :
38   -
39   - -n
40   - --no-lines
41   -
42   -For debugging option :
43   -To perform all processing without writing to any files, use :
44   -
45   - -g
46   - --debug
47   -
48   -=head1 Help
49   -
50   -For more help or any other question you go to L<http://parrot.org> or
51   -L<http://github.com/parrot/parrot>.Or you can send email to 'parrot-dev@parrot.org'.
52   -You are also invited to join the #parrot IRC channel on irc.parrot.org.
53   -
54   -=cut
80 binaries/parrot-nqp.pod
Source Rendered
... ... @@ -1,80 +0,0 @@
1   -# Copyright (C) 2001-2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -parrot-nqp - Not Quite Perl (6)
6   -
7   -=head1 Description
8   -
9   -This is "Not Quite Perl (6)" -- a High Level Language (HLL) which allows one to
10   -write Perl6-like code. The key feature of NQP is that it's designed to be an
11   -easy-to-parse subset of Perl 6. It is geared towards being a high-level way to
12   -create transformers for Parrot (especially HLL compilers). It is based on
13   -PCT::HLLCompiler.
14   -
15   -NQP is used as a bootstrapping language in for Rakudo, and hence developed
16   -outside of the main Parrot git repository. It is occasionally snapshotted into
17   -the main Parrot codebase so it can be bundled with Parrot releases and be used
18   -by core Parrot developers as well as HLL developers.
19   -
20   -=head1 Usage
21   -
22   -parrot-nqp <file>
23   -
24   -=head2 Command Line Usage
25   -
26   -For help use :
27   -
28   - -h
29   - --help
30   -
31   -To show version use :
32   -
33   - -v
34   - --version
35   -
36   -To display the parse tree for regular expression use :
37   -
38   - --target=parse
39   -
40   -To dispaly the PIR subroutine gererated to match the regular expression use :
41   -
42   - --target=pir
43   -
44   -For dumper use :
45   -
46   - --dumper=s
47   -
48   -To trace use :
49   -
50   - -t=s
51   - --trace=s
52   -
53   -For encoding use :
54   -
55   - --encoding=s
56   -
57   -To combine use :
58   -
59   - --combine
60   -
61   -For stage stats use :
62   -
63   - --stagestats
64   -
65   -For backtrace use :
66   -
67   - --ll-backtrace
68   -
69   -For output use :
70   -
71   - -o=s
72   - --output=s
73   -
74   -=head1 Help
75   -
76   -For more help or any other question you go to L<http://parrot.org> or
77   -L<http://github.com/parrot/parrot>.Or you can send email to 'parrot-dev@parrot.org'.
78   -You are also invited to join the #parrot IRC channel on irc.parrot.org.
79   -
80   -=cut
98 binaries/parrot-prove.pod
Source Rendered
... ... @@ -1,98 +0,0 @@
1   -# Copyright (C) 2001-2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -parrot-prove - Prove is a PIR-based TAP (Test Anything Protocol) Harness
6   -
7   -=head1 Description
8   -
9   -It eats test output (i.e. is a TAP consumer) and tells humans if the
10   -test suite passed, and if not, which kind of pretty colors of smoke
11   -came out. It is mostly equivalent to 'prove' from Perl 5.
12   -
13   -=head1 Usage
14   -
15   -parrot-prove [option] [files]
16   -
17   -=head2 Command line boolean options
18   -
19   -To print all test lines use :
20   -
21   - -v
22   - --verbose
23   -
24   -To run the tests in random order use :
25   -
26   - -s
27   - --shuffle
28   -
29   -To show failed tests use :
30   -
31   - -f
32   - --failures
33   -
34   -To show comments use :
35   -
36   - -o
37   - --comments
38   -
39   -To ignore exit status from test scripts use :
40   -
41   - --ignore-exit
42   -
43   -To merge test scripts STDERR with their STDOUT use :
44   -
45   - -m
46   - --merge
47   -
48   -To run tests in reverse order use :
49   -
50   - --reverse
51   -
52   -To suppress some test output while running tests use :
53   -
54   - -q
55   - --quiet
56   -
57   -To print only summary result use :
58   -
59   - -Q
60   - --QUIET
61   -
62   -To show only results with TODO or SKIP directives use :
63   -
64   - --directives
65   -
66   -To normalize TAP output in verbose output use :
67   -
68   - --normalize
69   -
70   -To display help use :
71   -
72   - -h
73   - --help
74   -
75   -To display version use :
76   -
77   - -v
78   - --version
79   -
80   -=head2 Command line options that take arguments
81   -
82   -To interpreter to run the tests (' ' for compiled tests.) use :
83   -
84   - -e
85   - --exec
86   -
87   -To store the resulting TAP in an archive file use :
88   -
89   - -a
90   - --archive
91   -
92   -=head1 Help
93   -
94   -For more help or any other question you go to L<http://parrot.org> or
95   -L<http://github.com/parrot/parrot>.Or you can send email to 'parrot-dev@parrot.org'.
96   -You are also invited to join the #parrot IRC channel on irc.parrot.org.
97   -
98   -=cut
417 binaries/parrot.pod
Source Rendered
... ... @@ -1,417 +0,0 @@
1   -# Copyright (C) 2011, Parrot Foundation.
2   -
3   -=pod
4   -
5   -=head1 NAME
6   -
7   -parrot - Parrot Virtual Machine
8   -
9   -=head1 SYNOPSIS
10   -
11   -B<parrot> [-options] <file> [arguments ...]
12   -
13   -=head1 DESCRIPTION
14   -
15   -Parrot is a virtual machine designed to efficiently compile and execute
16   -bytecode for dynamic languages. Parrot currently hosts a variety of language
17   -implementations in various stages of completion, including Tcl, Javascript,
18   -Ruby, Lua, Scheme, PHP, Python, Perl 6, APL, and a .NET bytecode translator.
19   -Parrot is not about parrots, but we are rather fond of them, for obvious
20   -reasons.
21   -
22   -=head1 OPTIONS
23   -
24   -=over 4
25   -
26   -=item B<-h>
27   -
28   -=item B<--help> Print the option summary on the command line.
29   -
30   -=item
31   -
32   -=item B<-V>
33   -
34   -=item B<--version> Print version information and exit.
35   -
36   -=item
37   -
38   -=item B<-I>
39   -
40   -=item B<--include> Add C<path> to the include search path.
41   -
42   -=item
43   -
44   -=item B<-L>
45   -
46   -=item B<--library> Add C<path> to the library search path.
47   -
48   -=item
49   -
50   -=item B<--hash-seed> [hexnum]
51   -
52   -=over 11
53   -
54   -Sets the hash seed to the specified value. This option is useful for debugging intermittent
55   -failures, but should I<not> be used in production. For more information about this option,
56   -I<see> F<docs/dev/profiling.pod>, F<docs/project/hacking_tips.pod>, F<docs/running.pod>,
57   -and F<docs/submissions.pod>.
58   -
59   -=back
60   -
61   -=item B<-X>
62   -
63   -=item B<--dynext> Add C<path> to the dynamic extension search path.
64   -
65   -=back
66   -
67   -=head2 Run core options
68   -
69   -These options select the runcore, which is useful for performance tuning and debugging. For more
70   -information about these options, I<see> the "About runcores" section in F<docs/running.pod>.
71   -
72   -=over 4
73   -
74   -=item B<-R>
75   -
76   -=item B<--runcore> [CORE]
77   -
78   -=over 11
79   -
80   -Select the runcore. The following cores are available in Parrot, but not all
81   -may be available on your system:
82   -
83   - slow, bounds bounds checking core (default)
84   -
85   - fast bare-bones core without bounds-checking or
86   - context-updating
87   -
88   - subprof subroutine-level profiler
89   - (see POD in 'src/runcore/subprof.c')
90   -
91   - trace bounds checking core with trace info
92   - (see 'parrot --help-debug')
93   -
94   - profiling see 'docs/dev/profilling.pod'
95   -
96   - gcdebug performs a full GC run before every op dispatch
97   - (good for debugging GC problems)
98   -
99   -=back
100   -
101   -=item B<-p>
102   -
103   -=item B<--profile> Run with the slow core and print an execution profile.
104   -
105   -=item
106   -
107   -=item B<-t>
108   -
109   -=item B<--trace> Run with the slow core and print trace information to B<stderr>.
110   -
111   -=over 11
112   -
113   -I<See> C<parrot --help-debug> for available flag bits.
114   -
115   -=back
116   -
117   -=back
118   -
119   -=head2 VM options
120   -
121   -=over 4
122   -
123   -=item B<-D>
124   -
125   -=item B<--parrot-debug>[=HEXFLAGS]
126   -
127   -=over 11
128   -
129   -Turn on interpreter debug flag. I<See> C<parrot --help-debug> for available flag bits.
130   -
131   -=back
132   -
133   -=item B<--help-debug> Print the summary of debugging and tracing flag bits.
134   -
135   -=item
136   -
137   -=item B<-w>
138   -
139   -=item B<--warnings> Turn on warnings.
140   -
141   -=over 11
142   -
143   -I<See> C<parrot --help-debug> for available flag bits.
144   -
145   -=back
146   -
147   -=item B<-G>
148   -
149   -=item B<--no-gc> Turn off GC.
150   -
151   -=over 11
152   -
153   -This may prove useful for finding GC-related bugs.
154   -
155   -=back
156   -
157   -=over 11
158   -
159   -=item Note:
160   -
161   -Do not use this option for longer running programs: since memory is no longer recycled, it may
162   -quickly become exhausted.
163   -
164   -=back
165   -
166   -=item B<-g>
167   -
168   -=item B<--gc> [GC-type]
169   -
170   -=back
171   -
172   -=head3 GC MS2 options
173   -
174   -=over 4
175   -
176   -=item B<--gc-dynamic-threshold>=percentage
177   -
178   -=over 11
179   -
180   -Maximum memory wasted by GC
181   -
182   -=back
183   -
184   -=item B<--gc-min-threshold>=Kb
185   -
186   -=back
187   -
188   -=head3 GC GMS options
189   -
190   -=over 4
191   -
192   -=item B<--gc-nursery-size>=percent of system
193   -
194   -=over 11
195   -
196   -Size of gen0 (default 2)
197   -
198   -=back
199   -
200   -=item B<--gc-debug> Turn on GC (Garbage Collection) debugging.
201   -
202   -=over 11
203   -
204   -This imposes some stress on the GC subsystem and can considerably slow
205   -down execution.
206   -
207   -=back
208   -
209   -=item B<--leak-test|--destroy-at-end>
210   -
211   -=over 11
212   -
213   -Free all memory of the last interpreter. This is useful when running leak
214   -checkers.
215   -
216   -=back
217   -
218   -=item B<-.>
219   -
220   -=item B<--wait> Read a keystroke before starting.
221   -
222   -=over 11
223   -
224   -This is useful when you want to attach a debugger on platforms such as Windows.
225   -
226   -=back
227   -
228   -=item B<--runtime-prefix>
229   -
230   -=over 11
231   -
232   -Print the runtime prefix path and exit.
233   -
234   -=back
235   -
236   -=back
237   -
238   -=head2 Compiler options
239   -
240   -=over 4
241   -
242   -=item B<-d>
243   -
244   -=item B<--imcc-debug>=[HEXFLAGS]
245   -
246   -=over 11
247   -
248   -The B<-d> switch takes an optional argument, consisting of a hexadecimal value
249   -of debug bits. If no value is supplied, 'debug' is set to 1.
250   -
251   -To list the individual bits on the command line, use the B<--help-debug> switch.
252   -
253   -To produce a vary large output on F<stderr>, run C<"parrot B<-d 0ffff> ...">.
254   -
255   -=back
256   -
257   -=item B<-v>
258   -
259   -=item B<--verbose> One C<-v> shows which files are worked on and prints
260   -
261   -=over 11
262   -
263   -a summary over register usage and optimization stats per I<subroutine>. With
264   -two C<-v> switches, C<parrot> prints a line per individual processing step too.
265   -
266   -=back
267   -
268   -=item B<-E>
269   -
270   -=item B<--pre-process-only>
271   -
272   -=over 11
273   -
274   -Preprocess source file (expand macros) and print result to C<stdout>:
275   -
276   - $> parrot -E t/op/macro_10.pasm
277   - $> parrot -E t/op/macro_10.pasm | parrot -- -
278   -
279   -=back
280   -
281   -=item B<-o>
282   -
283   -=item B<--output>=FILE Act like an assembler, but do not execute the code,
284   -
285   -=over 11
286   -
287   -unless the B<-r> is supplied as well. If 'outputfile' ends with F<.pbc>,
288   -'parrot' will write a PBC file. If it ends with F<.pasm>, 'parrot' will output
289   -a PASM file, even from PASM input. This can be useful when needing to check
290   -various optimizations, including C<-Op>.
291   -
292   -=back
293   -
294   -=item B<--output-pbc> Act like an assembler, but always output bytecode,
295   -
296   -=over 11
297   -
298   -even if the output file does not end in F<.pbc>
299   -
300   -=back
301   -
302   -=item B<-O>
303   -
304   -=item B<--optimize>[=LEVEL]
305   -
306   -=over 11
307   -
308   -Optimization levels
309   -
310   - -O0 no optimization (default)
311   - -O1 optimizations without life info (e.g. branches)
312   - -O same
313   - -O2 optimizations with life info
314   - -Op rewrite I and N PASM registers most used first
315   - -Ot select fastest runcore
316   - -Oc turns on the optional/experimental tail call optimizations
317   -
318   -I<See> F<docs/dev/optimizer.pod> for more information on the optimizer.
319   -
320   -=back
321   -
322   -=over 11
323   -
324   -=item Note:
325   -
326   -Optimization is currently an experimental feature and these options are likely to change.
327   -
328   -=back
329   -
330   -=item B<-a>
331   -
332   -=item B<--pasm> Assume PASM input on C<stdin>.
333   -
334   -=item B<-c>
335   -
336   -=item B<--pbc> Assume PBC file on C<stdin> and execute it.
337   -
338   -=over 11
339   -
340   -NOTE: If whitespace separates the B<-d> switch from the argument, the argument
341   -I<must> start with a number, I<i.e.>, a decimal digit.
342   -
343   -=back
344   -
345   -=item B<-r>
346   -
347   -=item B<--run-pbc> Only useful after C<-o> or C<--output-pbc>.
348   -
349   -=over 11
350   -
351   -Execute the program from the compiled in-memory image. If two C<-r> options are
352   -supplied, the F<.pbc> file is read from disc and executed. This is needed,
353   -primarily, for tests.
354   -
355   -=back
356   -
357   -=item B<-y>
358   -
359   -=item B<--yydebug> Turn on yydebug in F<yacc>/F<bison>.
360   -
361   -=back
362   -
363   -=head2 <file>
364   -
365   -If the file ends in F<.pbc> it will be interpreted immediately.
366   -
367   -If the file ends in F<.pasm>, then it is parsed as PASM code. Otherwise, it is
368   -parsed as PIR code. In both cases, it will then be executed, unless the C<-o>
369   -flag was supplied.
370   -
371   -If the C<file> is a single dash, input from C<stdin> is read.
372   -
373   -=head2 [arguments ...]
374   -
375   -Optional arguments passed to the running program as ARGV. The program is
376   -assumed to know what to do with the arguments.
377   -
378   -=head1 ENVIRONMENT
379   -
380   -=over 4
381   -
382   -=item PARROT_RUNTIME
383   -
384   -If this environment variable is set, parrot will use this path as its runtime
385   -prefix instead of the compiled-in path. This is useful if you want to execute
386   -a version of parrot different from the one on the "compiled-in" path.
387   -
388   -=item PARROT_GC_DEBUG
389   -
390   -Turn on the I<--gc-debug> flag.
391   -
392   -=back
393   -
394   -=head1 SEE ALSO
395   -
396   -'docs/running.pod' Additional information on command line options.
397   -
398   -http://www.parrot.org/ The official Parrot web site.
399   -
400   -http://docs.parrot.org/ Parrot's official documentation site.
401   -
402   -http://parrot.github.com/ An alternative documentation site.
403   -
404   -=head1 REPORTING BUGS
405   -
406   -For information on how to submit a bug report, I<see> F<docs/submissions.pod>.
407   -
408   -=head1 AUTHORS
409   -
410   -Parrot is a product of the contributions of a great many people. For a list of
411   -most of these people, I<see> F<CREDITS>.
412   -
413   -=head1 COPYRIGHT
414   -
415   -Copyright (C) 2001-2011, Parrot Foundation.
416   -
417   -=cut
36 binaries/parrot_config.pod
Source Rendered
... ... @@ -1,36 +0,0 @@
1   -# Copyright (C) 2011 Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -parrot_config - Parrot Configuration
6   -
7   -=head1 DESCRIPTION
8   -
9   -parrot_config can be used find out compile-time configuration information about
10   -the Parrot executable.
11   -
12   -=head1 SYNOPSIS
13   -
14   -To print every available key:
15   -
16   - parrot_config --dump
17   -
18   -With specific key it will print only it's corresponding value.
19   -
20   -To get the current version of Parrot:
21   -
22   - parrot_config VERSION
23   -
24   -To get a descriptive version string that will uniquely identify
25   -commits which are not releases:
26   -
27   - parrot_config git_describe
28   -
29   -=head1 Help
30   -
31   -For more help or any other question you go to L<http://parrot.org> or
32   -L<http://github.com/parrot/parrot>.Or you can send email to
33   -'parrot-dev@parrot.org'. You can also join Parrot IRC channel: #parrot
34   -on irc.parrot.org .
35   -
36   -=cut
73 binaries/parrot_nci_thunk_gen.pod
Source Rendered
... ... @@ -1,73 +0,0 @@
1   -# Copyright (C) 2001-2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -parrot_nci_thunk_gen - Create Parrot NCI thunks
6   -
7   -=head1 Description
8   -
9   -This utility creates C file of routines suitable for use as Parrot Native Call Interface thunks.
10   -
11   -=head1 Usage
12   -
13   - parrot_nci_thunk_gen [option] -o output_c_file.c < input_signature_list.nci
14   -
15   -=head2 Command line Options
16   -
17   -To print help message and exit use :
18   -
19   - --help
20   -
21   -To print version number of this utility use :
22   -
23   - --version
24   -
25   -Not to complain about duplicated signatures (default is to warn) use :
26   -
27   - -f
28   - --no-warn-dups
29   -
30   -To output a thunk file suitable for inclusion in Parrot core (default is no) use :
31   -
32   - --core
33   -
34   -To use default values for loader-name, loader-storage-class, and target suitable
35   -for use in Parrot dyntex library use :
36   -
37   - --dyntex
38   -
39   -To specify output file use :
40   -
41   - -o
42   - --output <file>
43   -
44   -To select what to output (valid operation are 'head', 'thunks', 'loader',
45   -'loader-dyntex', 'coda', 'all', 'all-dyntex', 'names' and 'signatures')
46   -(default is 'all') use :
47   -
48   - --target <target>
49   -
50   -To set storage class used for the thunks (default value is static) use :
51   -
52   - --thunk-storage-class <storage class>
53   -
54   -To set the prototype used for the thunk function names.Must be a printf
55   -format with arity 1 (default value is 'pcf_%s') use :
56   -
57   - --thunk-name-proto <printf prototype>
58   -
59   -To set the storage class used for the loader funtion (default value is none) use :
60   -
61   - --loader-storage-class
62   -
63   -To set the name used for the leader function (default value is 'Parrot_load_nci_thunks') use :
64   -
65   - --loader-name
66   -
67   -=head1 Help
68   -
69   -For more help or any other question you go to L<http://parrot.org> or
70   -L<http://github.com/parrot/parrot>.Or you can send email to 'parrot-dev@parrot.org'.
71   -You are also invited to join the #parrot IRC channel on irc.parrot.org.
72   -
73   -=cut
95 binaries/parrotbug.pod
Source Rendered
... ... @@ -1,95 +0,0 @@
1   -# Copyright (C) 2001-2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -parrotbug.pod - Parrot bug report
6   -
7   -=head1 Description
8   -
9   -A program to help generate bug reports about parrot, and mail them.
10   -It is designed to be used interactively. Normally no arguments will
11   -be needed.
12   -
13   -=head1 Usage
14   -
15   -parrotbug [option] [action]
16   -
17   -=head2 Comman line Options
18   -
19   -To report successful build on this system to parrot developers use :
20   -
21   - --ok
22   -
23   -Only use C<--ok> if everything was ok.If there were any problems at all, use :
24   -
25   - --nok
26   -
27   -It is used to Report unsuccessful build on system.
28   -
29   -To include specific summary with the message use :
30   -
31   - --summary <summary>
32   -
33   -To include specific category to the bug report use :
34   -
35   - --category <category>
36   -
37   -To include severity to the bug report use :
38   -
39   - --severity <severity>
40   -
41   -To set your emal addres use :
42   -
43   - --from <address>
44   -
45   -To open editor to use for editing the bug report use :
46   -
47   - --editor <editor>
48   -
49   -Not to send a bug report which receive acknowledgement use :
50   -
51   - --ack
52   - --noack
53   -
54   -To open a file containing the body of the report use :
55   -
56   - --input-file
57   -
58   -Use this to quickly send a prepared message.
59   -
60   -To view file where parrotbug will save it's bug report use :
61   -
62   - --output-file
63   -
64   -Note: you will be prompted if the program miss some information.
65   -
66   -=head2 Command line Actions
67   -
68   -To dump message use :
69   -
70   - --dump
71   -
72   -To save message use :
73   -
74   - --save
75   -
76   -To print help message and exit after that use :
77   -
78   - --help
79   -
80   -To print version information and exit after that use :
81   -
82   - --version
83   -
84   -=head1 Help
85   -
86   -For more help or any other question you go to L<http://parrot.org> or
87   -L<http://github.com/parrot/parrot>.Or you can send email to 'parrot-dev@parrot.org'.
88   -You are also invited to join the #parrot IRC channel on irc.parrot.org.
89   -
90   -=cut
91   -
92   -
93   -
94   -
95   -
67 binaries/pbc_to_exe.pod
Source Rendered
... ... @@ -1,67 +0,0 @@
1   -# Copyright (C) 2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -pbc_to_exe - Generate executables from Parrot bytecode
6   -
7   -=head1 Description
8   -
9   -This utility compiles bytecode to native executables. These are called
10   -"fakecutables", because they are actually just the bytecode packaged up as raw
11   -data inside a C skeleton.
12   -
13   -=head1 Usage
14   -
15   -pbc_to_exe [option] <file>
16   -
17   -=head2 Command line Options
18   -
19   -For help use :
20   -
21   - -h
22   - --help
23   -
24   -To install use :
25   -
26   - -i
27   - --install
28   -
29   -To runcore or to change runcore use :
30   -
31   - -R
32   - --runcore=slow|fast
33   -
34   -For output file use :
35   -
36   - -o
37   - --output=FILE
38   -
39   -To change garbage collector algorithm use :
40   -
41   - --gc=ms2|gms
42   -
43   -C<gms> is default. C<ms2> is older and slower
44   -
45   -=head2 Synopsis
46   -
47   - pbc_to_exe my.pbc
48   -
49   -Will generate :
50   -
51   - my.exe
52   -
53   -And
54   -
55   - pbc_to_exe my.pbc --install
56   -
57   -Will generate :
58   -
59   - installable_my.exe
60   -
61   -=head1 Help
62   -
63   -For more help or any other question you go to L<http://parrot.org> or
64   -L<http://github.com/parrot/parrot>.Or you can send email to 'parrot-dev@parrot.org'.
65   -You are also invited to join the #parrot IRC channel on irc.parrot.org.
66   -
67   -=cut
147 binaries/plumage.pod
Source Rendered
... ... @@ -1,147 +0,0 @@
1   -# Copyright (C) 2001-2011, Parrot Foundation.
2   -
3   -=head1 Name
4   -
5   -plumage.pod - Parrot Plumage
6   -
7   -=head1 Description
8   -
9   -Parrot Plumage is the Parrot Virtual Machine module ecosystem. It includes
10   -tools to search metadata, handle dependencies, install modules, and so forth.
11   -
12   -=head1 Usage
13   -
14   -plumage [<options>] <command> [<arguments>]
15   -
16   -=head1 Command line options
17   -
18   -For help about options and commands you can type:
19   -
20   - plumage usage
21   -
22   -Or to use command line option help :
23   -
24   - plumage -h
25   - plumage --help
26   -
27   -To read additional config file use :
28   -
29   - -c
30   -
31   -Or if you want to use specific path use :
32   -
33   - --config-file=<path>
34   -
35   -To ignore any failed build stages use :
36   -
37   - -i
38   - --ignore-fail
39   -
40   -To ignore fails only for specific stage use :
41   -
42   - --ignore-fail=<stage>
43   -
44   -You can repeat to select more than one stage.
45   -Not to ignore fail in specific stage use :
46   -
47   - --ignore-fail=<stage>=0
48   -
49   -=head1 Command line commands
50   -
51   -=head2 General commands
52   -
53   -To start interactive command-line interface (default with no commands) use :
54   -
55   - cli
56   -
57   -To display Plumage version and copyright statement use :
58   -
59   - version
60   -
61   -To display help message on specific command use :
62   -
63   - help [<command>]
64   -
65   -=head2 Query metadata and project info
66   -
67   -To list all known projects use :
68   -
69   - projects
70   -
71   -To show status of specific project use :
72   -
73   - status [<project>]
74   -
75   -To display detailed description of specific project use :
76   -
77   - info <project>
78   -
79   -To disp