This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Use F<> around file names
authorKarl Williamson <khw@cpan.org>
Thu, 7 May 2015 17:11:41 +0000 (11:11 -0600)
committerKarl Williamson <khw@cpan.org>
Sat, 1 Aug 2015 16:18:16 +0000 (10:18 -0600)
doio.c
mro_core.c
numeric.c
op.h
pp_ctl.c
sv.c
sv.h
util.c

diff --git a/doio.c b/doio.c
index ecfe3db..39e5ce7 100644 (file)
--- a/doio.c
+++ b/doio.c
@@ -2522,7 +2522,7 @@ Perl_do_shmio(pTHX_ I32 optype, SV **mark, SV **sp)
 Function called by C<do_readline> to spawn a glob (or do the glob inside
 perl on VMS).  This code used to be inline, but now perl uses C<File::Glob>
 this glob starter is only used by miniperl during the build process.
-Moving it away shrinks pp_hot.c; shrinking pp_hot.c helps speed perl up.
+Moving it away shrinks F<pp_hot.c>; shrinking F<pp_hot.c> helps speed perl up.
 
 =cut
 */
index 25d30d9..d134b8a 100644 (file)
@@ -1295,7 +1295,7 @@ XS code.
 
 2) Assigning a reference to a readonly scalar
 constant into a stash entry in order to create
-a constant subroutine (like constant.pm
+a constant subroutine (like F<constant.pm>
 does).
 
 This same method is available from pure perl
index 1900d10..6aeaf9f 100644 (file)
--- a/numeric.c
+++ b/numeric.c
@@ -808,7 +808,7 @@ Perl_grok_infnan(pTHX_ const char** sp, const char* send)
 Recognise (or not) a number.  The type of the number is returned
 (0 if unrecognised), otherwise it is a bit-ORed combination of
 IS_NUMBER_IN_UV, IS_NUMBER_GREATER_THAN_UV_MAX, IS_NUMBER_NOT_INT,
-IS_NUMBER_NEG, IS_NUMBER_INFINITY, IS_NUMBER_NAN (defined in perl.h).
+IS_NUMBER_NEG, IS_NUMBER_INFINITY, IS_NUMBER_NAN (defined in F<perl.h>).
 
 If the value of the number can fit in a UV, it is returned in the *valuep
 IS_NUMBER_IN_UV will be set to indicate that *valuep is valid, IS_NUMBER_IN_UV
@@ -1610,7 +1610,7 @@ Perl_my_frexpl(long double x, int *e) {
 Return a non-zero integer if the sign bit on an NV is set, and 0 if
 it is not.  
 
-If Configure detects this system has a signbit() that will work with
+If F<Configure> detects this system has a signbit() that will work with
 our NVs, then we just use it via the #define in perl.h.  Otherwise,
 fall back on this implementation.  The main use of this function
 is catching -0.0.
@@ -1621,7 +1621,7 @@ function or macro that doesn't happen to work with our particular choice
 of NVs.  We shouldn't just re-#define signbit as Perl_signbit and expect
 the standard system headers to be happy.  Also, this is a no-context
 function (no pTHX_) because Perl_signbit() is usually re-#defined in
-perl.h as a simple macro call to the system's signbit().
+F<perl.h> as a simple macro call to the system's signbit().
 Users should just always call Perl_signbit().
 
 =cut
diff --git a/op.h b/op.h
index 81ca391..95a2f05 100644 (file)
--- a/op.h
+++ b/op.h
@@ -915,7 +915,7 @@ structures it uses.  For core ops this currently gets the information out
 of PL_opargs, which does not always accurately reflect the type used.
 For custom ops the type is returned from the registration, and it is up
 to the registree to ensure it is accurate.  The value returned will be
-one of the OA_* constants from op.h.
+one of the OA_* constants from F<op.h>.
 
 =for apidoc Am|bool|OP_TYPE_IS|OP *o|Optype type
 Returns true if the given OP is not a NULL pointer
index d4f93b5..cc6a55f 100644 (file)
--- a/pp_ctl.c
+++ b/pp_ctl.c
@@ -3107,7 +3107,7 @@ Check for the cases 0 or 3 of cur_env.je_ret, only used inside an eval context.
 
 3 is used for a die caught by an inner eval - continue inner loop
 
-See cop.h: je_mustcatch, when set at any runlevel to TRUE, means eval ops must
+See F<cop.h>: je_mustcatch, when set at any runlevel to TRUE, means eval ops must
 establish a local jmpenv to handle exception traps.
 
 =cut
diff --git a/sv.c b/sv.c
index 7dedbca..383f53d 100644 (file)
--- a/sv.c
+++ b/sv.c
@@ -14234,7 +14234,7 @@ the ptr_table using the function
 C<ptr_table_free(PL_ptr_table); PL_ptr_table = NULL;>,
 reason to keep it around is if you want to dup some of your own
 variable who are outside the graph perl scans, example of this
-code is in threads.xs create.
+code is in F<threads.xs> create.
 
 CLONEf_CLONE_HOST -
 This is a win32 thing, it is ignored on unix, it tells perls
diff --git a/sv.h b/sv.h
index b6da18c..c84d73c 100644 (file)
--- a/sv.h
+++ b/sv.h
@@ -16,7 +16,7 @@
 =head1 SV Flags
 
 =for apidoc AmU||svtype
-An enum of flags for Perl types.  These are found in the file B<sv.h>
+An enum of flags for Perl types.  These are found in the file F<sv.h>
 in the C<svtype> enum.  Test these flags with the C<SvTYPE> macro.
 
 The types are:
diff --git a/util.c b/util.c
index 5912542..0a2c11e 100644 (file)
--- a/util.c
+++ b/util.c
@@ -6393,7 +6393,7 @@ be missing) tells how much inside the S_parse_body the program counter was.
 
 The util.c:1716 is the source code file and line number.
 
-The /usr/bin/perl is obvious (hopefully).
+The F</usr/bin/perl> is obvious (hopefully).
 
 Unknowns are C<"-">.  Unknowns can happen unfortunately quite easily:
 if the platform doesn't support retrieving the information;