dev-handbook: Split x86 assembly chapter into new article
ClosedPublic
Actions

Authored by mhorne on Jul 12 2024, 5:01 PM.

Details

Reviewers

0mp
emaste
ziaee
vladlen

Group Reviewers

doceng
docs

Commits

R9:936011df3b9c: dev-handbook: Split x86 assembly chapter into new article

Summary

The content of this chapter is niche, and has not been significantly
altered since its initial authorship in 2001. Still, it contains highly
detailed information that is still accurate on a largely
undocumented/esoteric topic. Therefore, it is worth preserving.

Moving this into a standalone article allows us to continue publishing
it while removing any expectation that the text should evolve or stay
up-to-date.

Diff Detail

Repository

R9 FreeBSD doc repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

mhorne requested review of this revision.Jul 12 2024, 5:01 PM

mhorne created this revision.

Harbormaster completed remote builds in B58625: Diff 140836.Jul 12 2024, 5:01 PM

mhorne added a child revision: D45962: x86-assembly: update the article a bit.Jul 12 2024, 5:01 PM

mhorne added a reviewer: doceng.Jul 12 2024, 5:02 PM

emaste accepted this revision.Jul 14 2024, 12:26 AM

This revision is now accepted and ready to land.Jul 14 2024, 12:26 AM

Complete the change by removing the content from the developers-handbook.

Do the same for the German and traditional Chinese versions of the document.

.po translations are still unhandled. I am looking into this.

This revision now requires review to proceed.Jul 18 2024, 4:16 PM

Harbormaster completed remote builds in B58704: Diff 141077.Jul 18 2024, 4:17 PM

Rebase. Handle moving the new Russian translation.

Harbormaster completed remote builds in B72260: Diff 175685.Apr 16 2026, 6:52 PM

mhorne added reviewers: ziaee, docs, vladlen.Apr 16 2026, 6:54 PM

mhorne added a child revision: D56430: x86-assembly: generate/update .po files.Apr 16 2026, 7:06 PM

If you move this to an article.
Please after putting it in production, remember to ask clusteradm@ to create a redirect in nginx

I didn't get very far yet, but a few comments so far. Thanks for inviting me!

documentation/content/en/articles/x86-assembly/_index.adoc
7	(I don't actually know what this field does, but I hope its for the search bar) This page mentions assembly compilers and the linker, which seems like useful search term. No need to mention as since the characters are a subset of llvm-as. I think x86 has been retconned as ia32, so it may be helpful to tag that as well.
1419	this link looks dead since 2023

ziaee added inline comments.Apr 17 2026, 12:48 AM

documentation/content/en/articles/x86-assembly/_index.adoc
1419	oops, I see now there's a stack of reviews

In D45961#1292026, @carlavilla wrote:

If you move this to an article.
Please after putting it in production, remember to ask clusteradm@ to create a redirect in nginx

Great suggestion, I will add this to my TODO.

documentation/content/en/articles/x86-assembly/_index.adoc
7	Same here, not sure. It seems to be a hugo thing; maybe it is for SEO. By quick experiment, it is not the search bar. Nonetheless I'll add a few more tags in the next revision.