Commit Graph

226 Commits

Author SHA1 Message Date
Xi Ruoyao
1cdc968198
building-notes: Mention -D_FORTIFY_SOURCE=3 2024-02-23 01:30:17 +08:00
Xi Ruoyao
fedbe2f15f
treewide: Use <ulink> instead of <filename> for referring man pages
Sync with LFS.

Note that in BLFS many man pages are even not referred via <filename>
and these references need to be found and fixed manually.
2024-01-27 19:50:40 +08:00
Pierre Labastie
ab4fdfccf8 Change all xml decl to encoding=utf-8 2024-01-19 22:39:35 +01:00
Pierre Labastie
2e072015eb Fix link to Wine site 2023-12-28 22:42:49 +01:00
Pierre Labastie
1859ee6872 Remove links to deleted wiki pages
See https://wiki.linuxfromscratch.org/blfs/ticket/18952
2023-12-23 13:40:25 +01:00
Pierre Labastie
f4ac71418d Remove many more forgotten ftp urls 2023-10-15 23:14:18 +02:00
Xi Ruoyao
087dc222a5
building-notes: Use bc instead of bash built-in for converting GB to B
It's more readable.

Also add an explanation about 2^30.
2023-09-19 03:54:59 +08:00
Xi Ruoyao
b6d544942b
building-notes: Note how to use cgroup for limiting resource usage
We were saying "-jN means using N cores (or N threads)".  This is
completely wrong. "-jN" only tells the building system to run N jobs
simultaneously, but each job can start their own subprocesses or threads
and there is no way for the building system to know how many
subprocesses or threads a job will start.

This caused a lot of misunderstandings and encouraged users to wrongly
blame building systems.

Fix the description of -jN, and add how to use cgroup to control the
usage of CPU cores and system RAM.

On a systemd-based system, systemd is the cgroup manager and manually
operating on cgroups may puzzle systemd.  So use systemd-run for
creating and setting up cgroup.  On a sysv-based system create and set
up the cgroup manually.
2023-09-19 02:59:45 +08:00
Douglas R. Reno
342d139a92 Typo fixes from rhubarbpieguy 2023-08-17 10:33:34 -05:00
Douglas R. Reno
5031e908be Typos by rhubarbpieguy 2023-08-11 15:31:37 -05:00
Xi Ruoyao
f9a6ca2d41
building-notes: Drop "qmake" from "using parent flags" examples
AFAIK to make Qt respect {C,CXX}FLAGS, you need to patch it.

Link:https://wiki.linuxfromscratch.org/blfs/wiki/qt5#CustomOptimizations
2023-07-22 12:27:01 +08:00
Xi Ruoyao
ec3211006d
building-notes: mention -Wl,-z,pack-relative-relocs 2023-07-22 12:26:23 +08:00
Xi Ruoyao
9b61265fd8
building-notes: Mention -Wl,{-O1,--as-needed} and -fno-semantic-interposition for optimization 2023-07-02 20:33:53 +08:00
Xi Ruoyao
6efdfbe5f9
building-notes: Format and update
- Do not use the single quote "'" for *everything*.  Use a proper XML
  tag if applicable.
- Don't call the source directory "build" directory because we now often
  create a subdirectory named "build", so calling the source directory
  "build" can be puzzling.
- Update the method to use compressed patch (matching libpng
  instruction).
- Explain why ninja attempts to use N+1 or N+2 logical processors.
- Now we don't run test suites w/o parallel jobs.
- Use "less" instead of "more" as "less" is actually more powerful.
- Explain -mtune=.
- -DNDEBUG is not always implied by --buildtype=release, but it's
  sometimes implied.
- Alert that some "Skylake"s are actually not -march=skylake.
- For Rust, explain "-O" and "-g".
2023-07-02 19:33:10 +08:00
Xi Ruoyao
42ddc3001a
treewide: Replace "User Notes" with "Editor Notes" 2023-06-30 02:18:51 +08:00
Xi Ruoyao
14891a9084
treewide: More "User Notes" clean up
Remove links to pages w/o real contents.
2023-06-30 02:18:51 +08:00
Xi Ruoyao
2a53093201
treewide: Remove nonexist User Notes
The last part of User Notes removal by
https://www.linuxfromscratch.org/~xry111/remove-nonexist-usernote.sh
2023-06-29 19:23:06 +08:00
Xi Ruoyao
7e255b8718
building-notes: Fix stupid typo in stripping script
I should have copied tested script file into the XML, instead of editing
it...
2023-04-01 17:36:16 +08:00
Xi Ruoyao
9b3319034f
building-notes: Update stripping script to preserve hard links 2023-03-24 16:22:43 +08:00
Xi Ruoyao
ad7f3b72dd
building-notes: Restructure my runtime addition to align with changes from Pierre
BTW, mention external optional dependencies.
2023-03-20 15:27:31 +08:00
Xi Ruoyao
bca432de82
building-notes: Explain runtime dependencies 2023-03-19 21:52:58 +08:00
Pierre Labastie
00231066f1 Clarify the role of runtime deps in conventions 2023-03-19 13:17:01 +01:00
Xi Ruoyao
640313a175
building-notes: remove an extra ")" 2023-01-30 17:38:57 +08:00
Xi Ruoyao
8d2373d88d
building-notes: Fix a grammar error 2023-01-30 17:35:18 +08:00
Xi Ruoyao
5a95524443
building-notes: Update harderning section to match the status quo
By the way, use <option> to decorate the compiler options.
2023-01-30 17:32:18 +08:00
Pierre Labastie
54d589072b Remove eol spaces 2023-01-29 13:51:59 +01:00
Bruce Dubbs
d7bdf9f08b Tweak stripping script 2023-01-07 15:28:10 -06:00
Bruce Dubbs
cf799ebe6e Tweak stripping script 2023-01-07 09:04:10 -06:00
Bruce Dubbs
17fe56e1be Update discussion of stripping installed files
Reformat the script and in the stripping section to make
it more clear and make it executable.
2023-01-06 15:13:50 -06:00
Ken Moffat
6ad6bace8b Expand gentoo details in Going Beyond BLFS. 2023-01-06 00:41:33 +00:00
Pierre Labastie
3f2db3a638 Remove sect1info tags
They only contain a date tag that is nowhere used.
2022-11-29 08:58:07 +01:00
Pierre Labastie
02743f9ca1 Explain how to have CMake always overwrite existing files 2022-10-02 17:50:46 +02:00
Pierre Labastie
c6c57f7fc6 Use an <informaltable> for explaining CMake flags 2022-10-02 17:50:01 +02:00
Xi Ruoyao
b3c16f1230
la-files: some reword
- libtool is usually internally shipped and system libtool is not used.
  Or we can simply patch system libtool to stop installing .la files...
- Add a paragraph about static library.  Prevent anyone from thinking
  "oh I need static libraries and I'll keep those .la files".
- Mention that .la file may mistakenly include library names or paths
  not valid after installation.
- Move a </literal> into the correct location.
2022-09-19 13:47:19 +08:00
Xi Ruoyao
824ddccf7a
introduction: URL clean up
- dreamwvr.com is dead now.
- freecode.com now redirects to SourceForge, add GitHub as well.
- use HTTPS if possible.
2022-09-08 12:04:07 +08:00
Bruce Dubbs
8159110a4d Typos 2022-08-21 19:29:21 -05:00
Julien Lepiller
9ca0948c69 Fix typos 2022-08-21 20:22:36 +02:00
Xi Ruoyao
7f17762a66
building-notes: add more info about stripping 2022-08-21 21:00:07 +08:00
Pierre Labastie
70957a40cf Add information about stripping
Propose a short script for stripping, which seems to work.
2022-08-21 13:49:45 +02:00
Xi Ruoyao
067189d7ea
building-notes: comment out bad stripping command
The stripping command will definitely destroy the system.  Leave it out
until we can figure out how to strip a running system correctly.

Link: https://lists.linuxfromscratch.org/sympa/arc/blfs-support/2022-08/msg00018.html
2022-08-21 08:16:03 +08:00
Pierre Labastie
403a9c620f Missing line return in the "library" page 2022-08-20 09:37:41 +02:00
Pierre Labastie
450ac1874f Update and tidy up the page about libraries
Prompted by a somewhat unhelpful comment in a mail of R Tegner.
2022-08-20 09:23:37 +02:00
Douglas R. Reno
df373d2730 Update URL for Stripping in Chapter 2 - Notes on Building Software. 2022-08-16 09:40:36 -05:00
Pierre Labastie
4c0df5c4d9 Fix some entities in general.ent for releases
Two entities downloads-root-systemd and patch-root were not
modified when switching to release:
- change the name of downloads-root-systemd to downloads-root since
the aim is to not have "-systemd" entities, and use "&blfs-version;"
for it
- create a patch-version entity (this one does not change for
systemd), and use it in patch-root
2022-03-01 10:07:36 +01:00
Bruce Dubbs
2c871871fb Spelling fixes 2022-02-16 15:04:13 -06:00
Pierre Labastie
a334dd2a3a Building Notes: tell why the number of jobs may have to be limited
Also tell how to limit the number of jobs with ninja
2022-02-13 19:24:50 +01:00
Bruce Dubbs
0a0ad3a17b Package updates.
Update to tree-2.0.0.
Update to pango-1.50.3.
Update to qpdf-10.5.0.
Update to libportal-0.5.
Update to gtk+3 3.24.31.
Update URLs in Beyond BLFS section.
2021-12-27 12:02:36 -06:00
Xi Ruoyao
97ba4252b4
building-notes: MD5 can be used to detect stealth update 2021-10-18 18:47:42 +08:00
Pierre Labastie
85580446b2 Remove spaces at the end of lines
I know it is somewhat useless, but I don't like them for
two reasons: first they cannot be seen, and I do not like things I
cannot see. Second, git highlights them, and this is disturbing...
2021-09-06 19:42:49 +02:00
Bruce Dubbs
dddebae741 Add a warning about stripping 2021-08-05 15:35:01 -05:00