Changeset 13a9dc2 for chapter01/askforhelp.xml
- Timestamp:
- 01/11/2006 12:02:10 PM (18 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- 1f3e44f
- Parents:
- 895a637
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter01/askforhelp.xml
r895a637 r13a9dc2 1 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 3 4 <!ENTITY % general-entities SYSTEM "../general.ent"> 4 5 %general-entities; 5 6 ]> 6 <sect1 id="prepare-askforhelp">7 <title>Help</title>8 <?dbhtml filename="askforhelp.html"?>9 7 10 <para>If an issue or a question is encountered while working 11 through this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>. 12 Questions are often already answered there. If your question is 13 not answered on this page, try to find the source of the problem. The 14 following hint will give you some guidance for troubleshooting: <ulink 15 url="&hints-root;errors.txt"/>.</para> 8 <sect1 id="ch-intro-askforhelp"> 9 <?dbhtml filename="askforhelp.html"?> 16 10 17 <para>If you cannot find your problem listed in the FAQ, search the mailing 18 lists at <ulink url="&lfs-root;search.html"/>.</para> 11 <title>Help</title> 19 12 20 <para>We also have a wonderful LFS community that is willing to offer assistance 21 through the mailing lists and IRC (see the <xref 22 linkend="ch-scatter-administrativa"/> section of this book). However, we get 23 several support questions everyday and many of them can be easily answered by 24 going to the FAQ and by searching the mailing lists first. So for us to offer 25 the best assistance possible, you need to do some research on your own first. 26 That allows us to focus on the more unusual support needs. If your searches do 27 not produce a solution, please include all relevant information (mentioned 28 below) in your request for help.</para> 13 <para>If an issue or a question is encountered while working through 14 this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>. 15 Questions are often already answered there. If your question is not 16 answered on this page, try to find the source of the problem. The 17 following hint will give you some guidance for troubleshooting: 18 <ulink url="&hints-root;errors.txt"/>.</para> 29 19 30 <sect2> 31 <title>Things to Mention</title> 32 33 <para>Apart from a brief explanation of the problem being experienced, 34 the essential things to include in any request for help are:</para> 20 <para>If you cannot find your problem listed in the FAQ, search the mailing 21 lists at <ulink url="&lfs-root;search.html"/>.</para> 35 22 36 <itemizedlist> 37 <listitem><para>The version of the book being used (in this case 38 &version;)</para></listitem> 39 <listitem><para>The host distribution and version being used to 40 create LFS</para></listitem> 41 <listitem><para>The package or section the problem was encountered in</para></listitem> 42 <listitem><para>The exact error message or symptom being received</para></listitem> 43 <listitem><para>Note whether you have deviated from the book at all </para></listitem> 44 </itemizedlist>23 <para>We also have a wonderful LFS community that is willing to offer 24 assistance through the mailing lists and IRC (see the <xref 25 linkend="ch-intro-resources"/> section of this book). However, 26 we get several support questions everyday and many of them can be easily 27 answered by going to the FAQ and by searching the mailing lists first. 28 So for us to offer the best assistance possible, you need to do some 29 research on your own first. That allows us to focus on the more unusual 30 support needs. If your searches do not produce a solution, please include 31 all relevant information (mentioned below) in your request for help.</para> 45 32 46 <note><para>Deviating from this book does <emphasis>not</emphasis> 47 mean that we will not help you. After all, LFS is about personal 48 preference. Being upfront about any changes to the established 49 procedure helps us evaluate and determine possible causes of your 50 problem.</para></note> 51 </sect2> 33 <sect2> 34 <title>Things to Mention</title> 52 35 53 <sect2> 54 <title>Configure Script Problems</title>36 <para>Apart from a brief explanation of the problem being experienced, 37 the essential things to include in any request for help are:</para> 55 38 56 <para>If something goes wrong while running the <command>configure</command> 57 script, review the <filename>config.log</filename> file. This file may 58 contain errors encountered during <command>configure</command> which were not 59 printed to the screen. Include the <emphasis>relevant</emphasis> lines if you 60 need to ask for help.</para> 61 </sect2> 39 <itemizedlist> 40 <listitem> 41 <para>The version of the book being used (in this case &version;)</para> 42 </listitem> 43 <listitem> 44 <para>The host distribution and version being used to create LFS</para> 45 </listitem> 46 <listitem> 47 <para>The package or section the problem was encountered in</para> 48 </listitem> 49 <listitem> 50 <para>The exact error message or symptom being received</para> 51 </listitem> 52 <listitem> 53 <para>Note whether you have deviated from the book at all </para> 54 </listitem> 55 </itemizedlist> 62 56 63 <sect2> 64 <title>Compilation Problems</title> 57 <note> 58 <para>Deviating from this book does <emphasis>not</emphasis> mean that 59 we will not help you. After all, LFS is about personal preference. 60 Being upfront about any changes to the established procedure helps us 61 evaluate and determine possible causes of your problem.</para> 62 </note> 65 63 66 <para>Both the screen output and the contents of various files are 67 useful in determining the cause of compilation problems. The screen output 68 from the <command>configure</command> script and the 69 <command>make</command> run can be helpful. It 70 is not necessary to include the entire output, but do include enough 71 of the relevant information. Below is an example of the type of 72 information to include from the screen output from <command>make</command>:</para> 64 </sect2> 65 66 <sect2> 67 <title>Configure Script Problems</title> 68 69 <para>If something goes wrong while running the <command>configure</command> 70 script, review the <filename>config.log</filename> file. This file may 71 contain errors encountered during <command>configure</command> which were 72 not printed to the screen. Include the <emphasis>relevant</emphasis> lines 73 if you need to ask for help.</para> 74 75 </sect2> 76 77 <sect2> 78 <title>Compilation Problems</title> 79 80 <para>Both the screen output and the contents of various files are useful 81 in determining the cause of compilation problems. The screen output from 82 the <command>configure</command> script and the <command>make</command> 83 run can be helpful. It is not necessary to include the entire output, but 84 do include enough of the relevant information. Below is an example of the 85 type of information to include from the screen output from 86 <command>make</command>:</para> 73 87 74 88 <screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\" 75 -DLOCALEDIR=\"/mnt/lfs/usr/share/locale\" 89 -DLOCALEDIR=\"/mnt/lfs/usr/share/locale\" 76 90 -DLIBDIR=\"/mnt/lfs/usr/lib\" 77 91 -DINCLUDEDIR=\"/mnt/lfs/usr/include\" -DHAVE_CONFIG_H -I. -I. 78 92 -g -O2 -c getopt1.c 79 gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o 80 expand.o file.o function.o getopt.o implicit.o job.o main.o 81 misc.o read.o remake.o rule.o signame.o variable.o vpath.o 93 gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o 94 expand.o file.o function.o getopt.o implicit.o job.o main.o 95 misc.o read.o remake.o rule.o signame.o variable.o vpath.o 82 96 default.o remote-stub.o version.o opt1.o 83 97 -lutil job.o: In function `load_too_high': 84 /lfs/tmp/make-3.79.1/job.c:1565: undefined reference 98 /lfs/tmp/make-3.79.1/job.c:1565: undefined reference 85 99 to `getloadavg' 86 100 collect2: ld returned 1 exit status … … 91 105 make: *** [all-recursive-am] Error 2</computeroutput></screen> 92 106 93 <para>In this case, many people would just include the bottom94 section:</para>107 <para>In this case, many people would just include the bottom 108 section:</para> 95 109 96 110 <screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen> 97 111 98 <para>This is not enough information to properly diagnose the problem99 because it only notes that something went wrong, not100 <emphasis>what</emphasis> went wrong.The entire section, as in the101 example above, is what should be saved because it includes the command102 that was executed and the associated error message(s).</para>112 <para>This is not enough information to properly diagnose the problem 113 because it only notes that something went wrong, not 114 <emphasis>what</emphasis> went wrong. The entire section, as in the 115 example above, is what should be saved because it includes the command 116 that was executed and the associated error message(s).</para> 103 117 104 <para>An excellent article about asking for help on the Internet is 105 available online at <ulink 106 url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and 107 follow the hints in this document to increase the likelihood of getting 108 the help you need.</para> 109 </sect2> 118 <para>An excellent article about asking for help on the Internet is 119 available online at <ulink 120 url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and 121 follow the hints in this document to increase the likelihood of getting 122 the help you need.</para> 123 124 </sect2> 110 125 111 126 </sect1> 112
Note:
See TracChangeset
for help on using the changeset viewer.