Merge pull request #1836 from titsuki/fix-pos

Fix link positions in the FAQ

Author: titsuki

doc/Language/faq.pod6

@@ -41,8 +41,8 @@ features were already implemented in 6.c compiler, due to the lack (at the
 time) of the infrastructure to support separate language versions.  Thus, when
 6.d is released, you may find you were already using many of the new features.
 
-=head2 As a Perl 6 user, what should I install?
 X<|Rakudo Star (FAQ)>
+=head2 As a Perl 6 user, what should I install?
 
 Mac users can use the latest Rakudo Star DMG binary installer at
 L<http://rakudo.org/downloads/star>
@@ -60,8 +60,8 @@ Rakudo release of 2015.12 should be avoided.
 There's an official Rakudo Star docker image at
 L<https://hub.docker.com/_/rakudo-star/>
 
-=head2 As an advanced user I want to track Rakudo development.
 X<|rakudobrew (FAQ)>
+=head2 As an advanced user I want to track Rakudo development.
 
 An option is to clone L<the repository|https://github.com/rakudo/rakudo> and
 L<build from source|https://github.com/zoffixznet/r#table-of-contents>.
@@ -120,15 +120,15 @@ There are several B<5to6-> guides in the L<Language section of the
 documentation|https://docs.perl6.org/language.html>, most notable of which
 is the L<5to6-nutshell|https://docs.perl6.org/language/5to6-nutshell> guide.
 
-=head2 I'm a Ruby programmer looking for quickstart type docs?
 X<|Ruby (FAQ)>
+=head2 I'm a Ruby programmer looking for quickstart type docs?
 
 See the L<rb-nutshell|https://docs.perl6.org/language/rb-nutshell> guide.
 
 =head1 Modules
 
-=head2 Is there a CPAN (repository of third party library modules) for Perl 6?
 X<|CPAN (FAQ)>X<|ecosystem>
+=head2 Is there a CPAN (repository of third party library modules) for Perl 6?
 
 Yes, it's the same L<CPAN|http://cpan.org/> as for Perl 5! The only difference
 is when using L<PAUSE|http://pause.perl.org/> to upload the module, you'd select
@@ -144,21 +144,21 @@ L<modules.perl6.org website|https://modules.perl6.org/> (temporarily, it's
 available as a
 L<raw JSON file|https://github.com/ugexe/Perl6-ecosystems/blob/master/cpan.json>
 
-=head2 Is there a perldoc (command line documentation viewer) for Perl 6?
 X<|p6doc (FAQ)>
+=head2 Is there a perldoc (command line documentation viewer) for Perl 6?
 
 Yes, it's called p6doc and is present in the ecosystem under that name. It's
 present in Rakudo Star but you will need to install it using the monthly
 release.
 
-=head2 Can I use Perl 5 modules from Perl 6?
 X<|Perl 5 modules (FAQ)>
+=head2 Can I use Perl 5 modules from Perl 6?
 
 Yes, with L<Inline::Perl5|https://github.com/niner/Inline-Perl5/>, which works
 well with most Perl 5 modules. It can even run Perl 5 Catalyst and DBI.
 
-=head2 Can I use C and C++ from Perl 6?
 X<|C and C++ (FAQ)>
+=head2 Can I use C and C++ from Perl 6?
 
 L<Nativecall|https://docs.perl6.org/language/nativecall> makes this
 particularly easy.
@@ -168,9 +168,9 @@ particularly easy.
 This is commonly seen on Debian-like systems. You need to install C<libfoo-dev>
 package, to set a sym link for the missing file.
 
-=head2 Where have all the traditional UNIX library functions gone?
 X<|UNIX library functions (FAQ)>
 X<|POSIX (FAQ)>
+=head2 Where have all the traditional UNIX library functions gone?
 
 It's very easy to use Nativecall to access them.
 
@@ -196,16 +196,16 @@ The target C<optimize> gives the AST after the static optimizer did its job,
 while target C<ast> gives the AST before that step. To get the full list of
 available targets, run C<perl6 --stagestats -e "">
 
-=head2 What is Precompilation?
 X<|Precompile (FAQ)>
+=head2 What is Precompilation?
 
 When you load a module for the first time, Rakudo compiles it into bytecode,
 and both stores it on disk, and uses the compiled bytecode. On subsequent
 loads, Rakudo prefers to load the bytecode, because that tends to be
 significantly faster.
 
-=head2 Can I have circular dependencies between modules?
 X<|Circular dependencies (FAQ)>
+=head2 Can I have circular dependencies between modules?
 
 No, you can't have circular dependencies, and you should
 get C<Circular module loading detected> error if you try it.
@@ -229,9 +229,9 @@ classes into the same compilation unit.
 
 =head1 Language Features
 
+X<|Data::Dumper (FAQ)>
 =head2 How can I dump Perl 6 data structures
 (like Perl 5 Data::Dumper and similar)?
-X<|Data::Dumper (FAQ)>
 
 Typical options are to use L<say> routine that uses L<gist> method that
 gives the "gist" of the object being dumped. More detailed output can be
@@ -378,8 +378,8 @@ Example of a definite return value:
 
 In this case, the final value is thrown away because the return value is already specified.
 
-=head2 How can I extract the values from a Junction?
 X<|Junction (FAQ)>
+=head2 How can I extract the values from a Junction?
 
 If you want to extract the values (eigenstates) from a
 L<Junction|/type/Junction>, you are probably doing something wrong and
@@ -466,8 +466,8 @@ on an expression, and item context (not flattening) with C<$( ... )>
 or by calling the C<.item> method on an expression.
 
 
-=head2 Why sigils? Couldn't you do without them?
 X<|sigils (FAQ)>
+=head2 Why sigils? Couldn't you do without them?
 
 There are several reasons:
 
@@ -494,8 +494,8 @@ hash key. Use a closure to help it to understand you.
     my $foo = "abc";
     say "{$foo}<html-tag>";
 
-=head2 Does Perl 6 have coroutines? What about C<yield>?
 X<|coroutine (FAQ)>
+=head2 Does Perl 6 have coroutines? What about C<yield>?
 
 Perl 6 has no C<yield> statement like Python does, but it does offer similar
 functionality through lazy lists. There are two popular ways to write
@@ -660,8 +660,8 @@ string|/type/Match>.
 
 C<OpaquePointer> is deprecated and has been replaced with C<Pointer>.
 
-=head1 Perl 6 Implementation
 X<|Perl 6 Implementation (FAQ)>
+=head1 Perl 6 Implementation
 
 =head2 What Perl 6 Implementations are available?
 
@@ -677,8 +677,8 @@ Quite Perl"). NQP is a lightweight Perl 6-like environment for virtual
 machines; it's designed to be a high-level way to create compilers and
 libraries for virtual machines (such as MoarVM and JVM) using Perl 6 syntax.
 
-=head2 What language is NQP written in?
 X<|NQP (FAQ)>
+=head2 What language is NQP written in?
 
 NQP is a mixture of (1) NQP code, (2) whatever language the underlying virtual
 machine is using, (3) some third-party C and Java libraries, and (4) some