eliz
808a64c171
Fix building extsnions on MinGW.
|
8 년 전 | |
|---|---|---|
| .. | ||
| lib | 8 년 전 | |
| m4 | 8 년 전 | |
| MANIFEST | 9 년 전 | |
| Makefile.PL | 9 년 전 | |
| Makefile.am | 9 년 전 | |
| README | 9 년 전 | |
| TestXS.pm | 8 년 전 | |
| TestXS.xs | 9 년 전 | |
| XSParagraph.xs | 8 년 전 | |
| config.in | 8 년 전 | |
| configure.ac | 8 년 전 | |
| fail.pl | 8 년 전 | |
| pm_to_blib | 9 년 전 | |
| ppport.h | 9 년 전 | |
| prepare_standalone_perl_module.sh | 9 년 전 | |
| text.c | 9 년 전 | |
| text.h | 9 년 전 | |
| xspara.c | 8 년 전 | |
| xspara.h | 8 년 전 | |
README
This is an experimental XS module to implement the functionality of
Texinfo::Convert::Paragraph.
Instructions for using this module
----------------------------------
Uncomment the lines in tp/Texinfo/Convert/Plaintext.pm that use this
module.
Caution: if you run an installed "makeinfo" from within the "tp/"
directory, it is likely to use the modules underneath "tp/", and not the
installed modules.
Debugging with gdb
------------------
To debug with gdb, create a .gdbinit file like the following:
dir Texinfo/Convert/XSParagraph/mylib
r texi2any
Run
export PERL5LIB=Texinfo/Convert/XSParagraph/lib:Texinfo/Convert/XSParagraph/blib/arch/auto/XSParagraph"
at the command line.
Run gdb as "gdb `which perl`". The .gdbinit file will load the symbols
from the source files. Then you can do e.g.
b xspara_end_line
in gdb. Run with "r texi2any (options)", for example,
"r texi2any ../doc/info-stnd.texi".
Issues
------
* Do we need to support more than one paragraph formatter at once? It
depends on what the calling code in Plaintext.pm does.
If this was necessary, the functions in XSParagraph.xs can call
xspara_set_state to make sure that the right paragraph state is used.
* Effect of changing locale. At initialization, xspara_hello tries to
switch to a UTF-8 locale, so that the C standard library multibyte
functions operate on the UTF-8 data correctly. Could this break
anything for the running Perl instance?
* Check that we correctly imitate variables being "undefined" in Perl.
* Check where space doubling at an end of a sentence is done - it is
done in a couple of places depending on some conditions, but the logic
of this isn't clear to me.
Texinfo::Convert::Paragraph.
Instructions for using this module
----------------------------------
Uncomment the lines in tp/Texinfo/Convert/Plaintext.pm that use this
module.
Caution: if you run an installed "makeinfo" from within the "tp/"
directory, it is likely to use the modules underneath "tp/", and not the
installed modules.
Debugging with gdb
------------------
To debug with gdb, create a .gdbinit file like the following:
dir Texinfo/Convert/XSParagraph/mylib
r texi2any
Run
export PERL5LIB=Texinfo/Convert/XSParagraph/lib:Texinfo/Convert/XSParagraph/blib/arch/auto/XSParagraph"
at the command line.
Run gdb as "gdb `which perl`". The .gdbinit file will load the symbols
from the source files. Then you can do e.g.
b xspara_end_line
in gdb. Run with "r texi2any (options)", for example,
"r texi2any ../doc/info-stnd.texi".
Issues
------
* Do we need to support more than one paragraph formatter at once? It
depends on what the calling code in Plaintext.pm does.
If this was necessary, the functions in XSParagraph.xs can call
xspara_set_state to make sure that the right paragraph state is used.
* Effect of changing locale. At initialization, xspara_hello tries to
switch to a UTF-8 locale, so that the C standard library multibyte
functions operate on the UTF-8 data correctly. Could this break
anything for the running Perl instance?
* Check that we correctly imitate variables being "undefined" in Perl.
* Check where space doubling at an end of a sentence is done - it is
done in a couple of places depending on some conditions, but the logic
of this isn't clear to me.