summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* Mark internal and document sv_peekKarl Williamson2022-05-072-1/+9
|
* perlapi: Document PERL_FLUSHALL_FOR_CHILDKarl Williamson2022-05-071-4/+12
|
* perlapi: Mark internal and document some save_FOO fcnsKarl Williamson2022-05-073-17/+95
| | | | These implement uppercase-named macros.
* perlapi: Mark internal, document (push|pop)_scopeKarl Williamson2022-05-072-2/+18
|
* Mark internal and document my_cxt_initKarl Williamson2022-05-072-7/+13
|
* Mark internal and document op_refcnt_lock/unlock()Karl Williamson2022-05-072-2/+18
|
* op.h: Add commentKarl Williamson2022-05-071-1/+1
|
* perlapi: "Uvf" is a formatKarl Williamson2022-05-071-0/+1
|
* Mark internal and document my_fflush_allKarl Williamson2022-05-072-1/+10
|
* autodoc: Rmv obsolete lineKarl Williamson2022-05-071-1/+0
| | | | | | This defines a variable if not defined, and dates from earlier logic, and wasn't removed when that logic changed. This line hid bugs that the next line is supposed to catch.
* autodoc: sv_inline.h fcns are going to be for SVKarl Williamson2022-05-071-0/+1
|
* Mark do_sprintf() as core onlyKarl Williamson2022-05-062-1/+10
|
* pp_ctl.c: Update commentsKarl Williamson2022-05-061-3/+3
| | | | pp_subst has been moved out of this file and into pp_hot.c
* Mark taint_proper,taint_env as core onlyKarl Williamson2022-05-061-2/+2
| | | | | Outside code should likely be using the wrapping macros TAINT_PROPER, TAINT_ENV
* perlapi,perlintern: Add tainting sectionKarl Williamson2022-05-063-1/+6
| | | | | | Tainting is so specialized that things dealing with it are better gathered together in one place. This commit moves the existing docs for such API into the new section
* mathoms.c pod: Add perlapi section namesKarl Williamson2022-05-061-0/+22
| | | | | | | | | | | | | | This adds section names of what section each non-adjacent function should go into in perlapi, perlintern. Sections are in effect until the next command changing it. As functions are added/removed from this file, they may inadvertently get placed in the wrong api section by virtue of inheriting the previous section name. Guard against that by specifying the proper section the pod for each function that is not in the same pod /* comment */ as another function. This change fixed a bug where one function was shown in the wrong section in perlapi.
* perlhist: Fix overlong verbatim pod lineKarl Williamson2022-05-062-2/+2
|
* perlhack: Fix some pod markup, overlong verbatimKarl Williamson2022-05-062-9/+8
| | | | | | | the F<> marker shouldn't need to be told whether or not to use "" to demarcate its argument. It should know what to do. Also fix some overlong verbatim lines
* perlapi: Create proper hyperlinkKarl Williamson2022-05-061-1/+1
|
* perlop: Clarify parts of tr///Karl Williamson2022-05-061-20/+32
|
* podcheck.t: Change $variable nameKarl Williamson2022-05-041-4/+4
| | | | This makes it clearer
* podcheck.t: Skip conflict markers in db fileKarl Williamson2022-05-041-1/+2
| | | | | | When rebasing, you can get conflicts. The simplest solution for a generated file is to regenerate it. But prior to this commit, all such lines would have to be manually removed.
* podcheck.t: Don't chdir without checking if feasibleKarl Williamson2022-05-041-1/+1
| | | | | This converts this file to follow the paradigm everywhere else, to chdir to 't' only if 't' is a directory
* podcheck.t: --show-all doesn't output skipped problemsKarl Williamson2022-05-041-4/+18
| | | | | | | | | | | | | | Before this commit, specifying --show-all caused a fire hose of messages to appear from pods that have many known problems, and whose output is completely suppressed normally. An example is perlepigraphs, where many lines are verbatim quotes from literature, and hence exceed our length limit, but we aren't going to change wrap them (some of them are poetry), so the output from that file of that type of problem is just completely suppressed. This commit keeps such output suppressed while showing all other issues. You can still get the suppressed output unsuppressed by explicitly specifying the file on the command line.
* POSIX.pod: Use proper hyperlinkKarl Williamson2022-05-041-1/+1
|
* perlpodstyle: Add proper hyperlinkKarl Williamson2022-05-041-1/+1
|
* bisect-runner: Fix verbatim line lengthKarl Williamson2022-05-042-8/+7
| | | | | This changes the indent to the minimum necessary to trigger pod verbatim line handling. Doing so stops the wrapping in this file.
* README.os390: Add proper hyperlinkKarl Williamson2022-05-041-1/+1
|
* README.os2: Fix podKarl Williamson2022-05-042-5/+6
| | | | Fix how links are displayed, add some links
* README.irix: Fix overlong verbatim lineKarl Williamson2022-05-042-2/+1
|
* perldebguts: Fix grammarKarl Williamson2022-05-041-1/+1
| | | | Use a real word instead of slang.
* Porting/todo.pod: Use L<> link, not F<>, for linkKarl Williamson2022-05-041-1/+1
|
* todo.pod: Use m// instead of //Karl Williamson2022-05-042-3/+2
| | | | | This makes it slightly easier for readers to understand, and a lot easier for podcheck.t to understand
* RMG: Use hpyerlinkKarl Williamson2022-05-041-1/+1
|
* podcheck.t: Treat some additional files speciallyKarl Williamson2022-05-042-2/+6
| | | | | metaconfig units and plain text files aren't pod. And lines like Perl/perl.git aren't going to be file names.
* podcheck.t: White-space, comments, typosKarl Williamson2022-05-041-17/+17
| | | | | This does some white space changes for readability, clarifies comments and pod.
* podcheck.t: Allow dash in argument namesKarl Williamson2022-05-041-16/+17
| | | | | In addition to being able to call this with --add_link, you can now specify --add-link, depending on your preference.
* podcheck.t: Set $| to 1Karl Williamson2022-05-041-0/+2
| | | | | | | This causes the output to be flushed immediately. Without this, some options that tried to tell you that the operation would take a while to complete would not have that message come out until it had in fact completed. The message should be displayed immediately.
* Amiga-Exec/Exec.pm: Fix podKarl Williamson2022-05-042-4/+3
| | | | | This line has a syntax error in it. Fix it, and split into two lines so doesn't wrap on output in an 80 column terminal window
* lib/perl5db.pl: Give proper pod linksKarl Williamson2022-05-042-4/+7
| | | | These internal references are linkable
* lib/perl5db.pl: Add some S<> to podKarl Williamson2022-05-041-13/+14
| | | | | | | | I added these to surround some C<...> that have spaces so that the output construct is guaranteed to be on a single line. These are mostly commands to type, and it is clearer to the reader if they kept together. I didn't bother with things that were guaranteed to be at the beginning of a line, as they won't wrap anyway.
* inline.h: Fix typo in commentKarl Williamson2022-05-041-1/+1
|
* [MERGE] Refactor regen/warnings.plDavid Mitchell2022-05-041-151/+228
|\ | | | | | | | | | | | | | | | | The src for this tool was a mess: it started out 20 years ago as a small utility, then grew. Lots of badly-named global variables, no code comments about what subs do etc. This series of commits cleans things up, refactors, adds comments etc. In theory it makes no functional changes, and indeed as run currently it generates exactly the same warnings.h and lib/warning.pm files as before.
| * regen/warnings.pl: rename $tre to $treeDavid Mitchell2022-05-041-13/+13
| | | | | | | | | | Since the global variable $tree was renamed $TREE, we can now rename all the instances of a sub parameter $tre to '$tree'.
| * regen/warnings.pl: add comments about $TREEDavid Mitchell2022-05-041-0/+17
| | | | | | | | | | Explain this structure, which is the input used to define all the warnings.
| * regen/warnings.pl: rename filehandle variablesDavid Mitchell2022-05-041-36/+39
| | | | | | | | | | rename my($warn, $pm) to ($warn_h, $warn_pm) to make it easier to see that they're the filehandles for warnings.h and warnings.pm
| * regen/warnings.pl: better comment what the subs doDavid Mitchell2022-05-041-0/+22
| |
| * regen/warnings.pl: eliminate broken dup checkDavid Mitchell2022-05-041-2/+0
| | | | | | | | | | | | | | | | valueWalk() checks for a duplicate warnings name. However, 1) This is also done in walk(), so is redundant. 2) It is broken. Originally it declared @list but checked %list; %list is global and was renamed to %CATEGORIES to make it clear it was a global (and thus unrelated to @list). So its probably never worked.
| * regen/warnings.pl: eliminate global %v_list varDavid Mitchell2022-05-041-7/+28
| | | | | | | | | | This lexical had global scope. Instead, make it a parameter to sub valueWalk(), since it's only used temporarily by two subs.
| * regen/warnings.pl: eliminate lexical var %ValueDavid Mitchell2022-05-041-2/+0
| | | | | | | | This doesn't seem to be used any more