AuroraMiddleware/glibc
1
0
Fork 0
mirror of https://sourceware.org/git/glibc.git synced 2025-01-03 16:21:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Move FAQ to wiki

Browse Source 
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 2012-05-03 09:46:57 +02:00
parent e2dbf201ab
commit 7ac30cc5f0
6 changed files with 15 additions and 3828 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
ChangeLog
View File

@ -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> 2012-05-02 Allan McRae <allan@archlinux.org>
* elf/Makefile: (LDFLAGS-nodel2mod3.so: Use $(no-as-needed). * elf/Makefile: (LDFLAGS-nodel2mod3.so: Use $(no-as-needed).

1976
FAQ
View File

File diff suppressed because it is too large Load Diff

1701
FAQ.in
View File

File diff suppressed because it is too large Load Diff

4
Makefile
View File

@ -363,7 +363,7 @@ TAGS:
generated := $(generated) stubs.h 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. # Regenerate stuff, then error if these things are not committed yet.
dist-prepare: $(files-for-dist) dist-prepare: $(files-for-dist)
@ -400,8 +400,6 @@ endef
INSTALL: manual/install.texi manual/macros.texi; $(format-me) INSTALL: manual/install.texi manual/macros.texi; $(format-me)
manual/dir-add.texi manual/dir-add.info: FORCE manual/dir-add.texi manual/dir-add.info: FORCE
$(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F) $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
FAQ: scripts/gen-FAQ.pl FAQ.in
$(PERL) $^ > $@.new && rm -f $@ && mv $@.new $@ && chmod a-w $@
FORCE: FORCE:
iconvdata/% localedata/% po/% manual/%: FORCE iconvdata/% localedata/% po/% manual/%: FORCE

8
manual/install.texi
View File

@ -7,10 +7,10 @@
@c %MENU% How to install the GNU C Library @c %MENU% How to install the GNU C Library
@appendix Installing @theglibc{} @appendix Installing @theglibc{}
Before you do anything else, you should read the file @file{FAQ} located Before you do anything else, you should read the FAQ at
at the top level of the source tree. This file answers common questions @url{http://sourceware.org/glibc/wiki/FAQ}. It answers common
and describes problems you may experience with compilation and questions and describes problems you may experience with compilation
installation. It is updated more frequently than this manual. and installation.
Features can be added to @theglibc{} via @dfn{add-on} bundles. These are 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 separate tar files, which you unpack into the top level of the source

144
scripts/gen-FAQ.pl
View File

@ -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";
}