Move FAQ to wiki
The FAQ is now at http://sourceware.org/glibc/wiki/FAQ and not anymore part of the repository.
This commit is contained in:
Andreas Jaeger
parent
e2dbf201ab
commit
7ac30cc5f0
10
ChangeLog
10
ChangeLog
|
|
@ -1,3 +1,13 @@
|
|||
2012-05-03 Andreas Jaeger <aj@suse.de>
|
||||
|
||||
* FAQ: Removed.
|
||||
* FAQ.in: Likewise.
|
||||
* scripts/gen-FAQ.pl: Likewise.
|
||||
* manual/install.texi (Installation): Point to online location of
|
||||
FAQ.
|
||||
* Makefile (files-for-dist): Remove FAQ.
|
||||
(FAQ): Remove.
|
||||
|
||||
2012-05-02 Allan McRae <allan@archlinux.org>
|
||||
|
||||
* elf/Makefile: (LDFLAGS-nodel2mod3.so: Use $(no-as-needed).
|
||||
|
|
|
|||
4
Makefile
4
Makefile
|
|
@ -363,7 +363,7 @@ TAGS:
|
|||
|
||||
generated := $(generated) stubs.h
|
||||
|
||||
files-for-dist := README FAQ INSTALL configure ChangeLog NEWS
|
||||
files-for-dist := README INSTALL configure ChangeLog NEWS
|
||||
|
||||
# Regenerate stuff, then error if these things are not committed yet.
|
||||
dist-prepare: $(files-for-dist)
|
||||
|
|
@ -400,8 +400,6 @@ endef
|
|||
INSTALL: manual/install.texi manual/macros.texi; $(format-me)
|
||||
manual/dir-add.texi manual/dir-add.info: FORCE
|
||||
$(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
|
||||
FAQ: scripts/gen-FAQ.pl FAQ.in
|
||||
$(PERL) $^ > $@.new && rm -f $@ && mv $@.new $@ && chmod a-w $@
|
||||
FORCE:
|
||||
|
||||
iconvdata/% localedata/% po/% manual/%: FORCE
|
||||
|
|
|
|||
|
|
@ -7,10 +7,10 @@
|
|||
@c %MENU% How to install the GNU C Library
|
||||
@appendix Installing @theglibc{}
|
||||
|
||||
Before you do anything else, you should read the file @file{FAQ} located
|
||||
at the top level of the source tree. This file answers common questions
|
||||
and describes problems you may experience with compilation and
|
||||
installation. It is updated more frequently than this manual.
|
||||
Before you do anything else, you should read the FAQ at
|
||||
@url{http://sourceware.org/glibc/wiki/FAQ}. It answers common
|
||||
questions and describes problems you may experience with compilation
|
||||
and installation.
|
||||
|
||||
Features can be added to @theglibc{} via @dfn{add-on} bundles. These are
|
||||
separate tar files, which you unpack into the top level of the source
|
||||
|
|
|
|||
|
|
@ -1,144 +0,0 @@
|
|||
#! /usr/bin/perl
|
||||
|
||||
=pod
|
||||
This is a silly little program for generating the libc FAQ.
|
||||
|
||||
The input format is:
|
||||
top boilerplate
|
||||
^L
|
||||
? section name (one line)
|
||||
?? question...
|
||||
...
|
||||
{ID} answer...
|
||||
...
|
||||
^L
|
||||
{ID} name <email@address>
|
||||
...
|
||||
|
||||
which gets mapped to:
|
||||
|
||||
top boilerplate
|
||||
^L
|
||||
1. section 1...
|
||||
1.1. q1.1
|
||||
1.2. q1.2
|
||||
...
|
||||
^L
|
||||
1. section 1...
|
||||
|
||||
1.1. q1.1
|
||||
|
||||
answer 1.1....
|
||||
|
||||
|
||||
^L
|
||||
Answers were provided by:
|
||||
...
|
||||
|
||||
=cut
|
||||
|
||||
# We slurp the whole file into a pair of assoc arrays indexed by
|
||||
# the 'section.question' number.
|
||||
%questions = ();
|
||||
%answers = ();
|
||||
$question = 0;
|
||||
|
||||
# These arrays and counter keep track of the sections.
|
||||
@sectcount = ();
|
||||
@sections = ();
|
||||
$section = 0;
|
||||
|
||||
# Cross reference list.
|
||||
%refs = ();
|
||||
|
||||
# Separators.
|
||||
$sepmaj = "\f\n" . ('~ ' x 36) . "\n\n";
|
||||
$sepmin = "\f\n" . ('. ' x 36) . "\n\n";
|
||||
|
||||
# Pass through the top boilerplate.
|
||||
while(<>)
|
||||
{
|
||||
last if $_ eq "\f\n";
|
||||
print;
|
||||
}
|
||||
|
||||
# Now the body.
|
||||
while(<>)
|
||||
{
|
||||
/\f/ && do
|
||||
{
|
||||
$sectcount[$section] = $question;
|
||||
last;
|
||||
};
|
||||
|
||||
s/^\?\s+// && do
|
||||
{
|
||||
chomp;
|
||||
$sectcount[$section] = $question if $section > 0;
|
||||
$section++;
|
||||
$sections[$section] = $_;
|
||||
$question = 0;
|
||||
next;
|
||||
};
|
||||
s/^\?\?(\w*?)\s+// && do
|
||||
{
|
||||
$cur = \%questions;
|
||||
$question++;
|
||||
$questions{$section,$question} = $_;
|
||||
$refs{$1} = "$section.$question" if $1 ne "";
|
||||
next;
|
||||
};
|
||||
/^\{/ && do
|
||||
{
|
||||
$cur = \%answers;
|
||||
$answers{$section,$question} .= $_;
|
||||
next;
|
||||
};
|
||||
|
||||
${$cur}{$section,$question} .= $_;
|
||||
}
|
||||
|
||||
# Now we have to clean up the newlines and deal with cross references.
|
||||
foreach(keys %questions) { $questions{$_} =~ s/\n+$//; }
|
||||
foreach(keys %answers)
|
||||
{
|
||||
$answers{$_} =~ s/\n+$//;
|
||||
$answers{$_} =~ s/(\s)\?(\w+)\b/$1 . "question " . ($refs{$2} or badref($2,$_), "!!$2")/eg;
|
||||
}
|
||||
|
||||
# Now output the formatted FAQ.
|
||||
print $sepmaj;
|
||||
for($i = 1; $i <= $section; $i++)
|
||||
{
|
||||
print "$i. $sections[$i]\n\n";
|
||||
for($j = 1; $j <= $sectcount[$i]; $j++)
|
||||
{
|
||||
print "$i.$j.\t$questions{$i,$j}\n";
|
||||
}
|
||||
print "\n";
|
||||
}
|
||||
|
||||
print $sepmaj;
|
||||
for($i = 1; $i <= $section; $i++)
|
||||
{
|
||||
print "$i. $sections[$i]\n\n";
|
||||
for($j = 1; $j <= $sectcount[$i]; $j++)
|
||||
{
|
||||
print "$i.$j.\t$questions{$i,$j}\n\n";
|
||||
print $answers{$i,$j}, "\n\n";
|
||||
print "\n" if $j < $sectcount[$i];
|
||||
}
|
||||
print $sepmin if $i < $section;
|
||||
}
|
||||
|
||||
print $sepmaj;
|
||||
|
||||
# Pass through the trailer.
|
||||
while(<>) { print; }
|
||||
|
||||
sub badref
|
||||
{
|
||||
my($ref,$quest) = @_;
|
||||
$quest =~ s/$;/./;
|
||||
print STDERR "Undefined reference to $ref in answer to Q$quest\n";
|
||||
}
|
||||
Loading…
Reference in a new issue