Commit Graph

71 Commits

Author SHA1 Message Date
Pierre Labastie
ab4fdfccf8 Change all xml decl to encoding=utf-8 2024-01-19 22:39:35 +01: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
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
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
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
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
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
Douglas R. Reno
df373d2730 Update URL for Stripping in Chapter 2 - Notes on Building Software. 2022-08-16 09:40:36 -05: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
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
Bruce Dubbs
7a3422b1e4 Fix stripping discussion for merged /usr 2021-08-05 15:10:37 -05:00
Xi Ruoyao
633329679c
building notes: stop to use MD5 for genuity verification, ...
use SHA256 or GnuPG instead.
2021-07-22 19:59:42 +08:00
Xi Ruoyao
8554ad2de7
building-notes: English grammar fix
https://thewritepractice.com/how-to-use-either-neither-or-and-nor-correctly/
2021-06-11 16:23:12 +08:00
Xi Ruoyao
65877d86d3
update building-notes and meson buildtype xinclude
Some packages are using debugoptimized in meson.build.
2021-06-11 16:18:52 +08:00
Xi Ruoyao
c98fc5bedc
update building notes for meson default buildtype
I'm not sure when "debug" became default though...
2021-06-04 19:38:48 +08:00
Xi Ruoyao
c9aa98043d
secure LFS url 2021-04-23 19:00:10 +08:00
Xi Ruoyao
45ab6c70c2
more SVN prop clean up
Remove "$LastChanged$" everywhere, and also some unused $Date$
2021-04-20 19:12:02 +08:00
Ken Moffat
bf5fb9456a Update to llvm-11.0.0 and rustc-1.47.0.
Patch firefox and thunderbird for this version of rust.
Remeasure all packages which use rust -
I think I used an out of date mozconfig when I updated thunderbird.
In general, builds are slower and slightly larger, but installs are marginally smaller.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23843 af4574ff-66df-0310-9fd7-8a98e5e911e0
2020-10-26 21:44:17 +00:00
Ken Moffat
5ce1bdb06c Rust: explain how to (mostly) restrict how many processors it wants to use.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23349 af4574ff-66df-0310-9fd7-8a98e5e911e0
2020-06-30 17:45:38 +00:00
Ken Moffat
c0e4599ea2 Build systems - remark that there are some cmake packages (not necessarily in BLFS)
which produce bad ninja.build files but usable Makefiles.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22751 af4574ff-66df-0310-9fd7-8a98e5e911e0
2020-02-23 03:55:40 +00:00
Ken Moffat
7c93be0325 A couple more typo fixes from my previous commit.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21860 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-07-24 15:04:10 +00:00
Douglas R. Reno
52249aa0a4 Fix QtWebEngine's background rendering and multimedia crash problems, as well as adapt it to Linux 5.2+ API
Typo fix in 'Notes on Building Software'

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21859 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-07-24 14:49:55 +00:00
Ken Moffat
8fd509cbe7 Expand Notes on Building Software.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21858 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-07-24 03:31:03 +00:00
Ken Moffat
f66b2ee545 Simplify instructions for finding available meon options.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21420 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-04-01 21:12:06 +00:00
Bruce Dubbs
367853f6b3 Minor wording changes in sw notes
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21417 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-03-30 22:51:46 +00:00
Ken Moffat
ab8c10c897 Start to document some of the differences in cmake and ninja.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21415 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-03-30 21:36:23 +00:00
Bruce Dubbs
1c3f6da1bc Make stripping command more robust.
Use a better URL for lsof.



git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21257 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-02-27 04:49:50 +00:00