OSC2021 Nagoya 「ゼロからのOS自作入門」の執筆を支える技術
•Download as PPTX, PDF•
1 like•758 views
「ゼロからのOS自作入門」を執筆する際に活用したOSSツールを紹介します。また、執筆中によく使ったGit Rebaseのテクニックも説明します。
Recommended
More Related Content
More from uchan_nos
More from uchan_nos (20)
OSC2021 Nagoya 「ゼロからのOS自作入門」の執筆を支える技術
- 8. Re:VIEW記法 「ゼロからのOS自作入門」で使った記法を一部紹介 等幅フォント @<tt>{Main.c} 画像参照 @<img>{event-propagation} 画像埋め込み //image[event-propagation][イベントの伝搬][scale=0.8]{ //} 索引登録 @<idx>{タイマ} 脚注参照 @<fn>{heavy-task} 脚注 //footnote[heavy-task][脚注本文] ユーザ定義タグも作れる 等幅フォント化+索引登録 @<codeidx>{SendMouseMessage()}
- 9. ラフ図案を手軽に描く
- 10. ラフ図案 本文を執筆中に図を入れたくなることがある その場で本格的な作図をしたくない 本格的な作図により、本文用の脳内メモリが奪われる ASCIIアートで本文中に描いて、それを図の代用としたい //image[layering][レイヤによる画面描画][scale=0.9]{ マウスのレイヤ --> -------------------- ＼ ---- ＼ デスクトップの --> - ＼ ＼ ↑ ＼ <---＼--- マウスのウィンドウ レイヤ ＼ ＼ ---- ＼ ＼ -------------------- ＼ ＼ -------------------- //}
- 17. main.cppの内容の変遷 extern "C" void KernelMain() { while (1) __asm__("hlt"); } osbook_day03aのmain.cpp #include <cstdint> extern "C" void KernelMain(uint64_t frame_buffer_base, uint64_t frame_buffer_size) { uint8_t* frame_buffer = reinterpret_cast<uint8_t*>(frame_buffer_base); for (uint64_t i = 0; i < frame_buffer_size; ++i) { frame_buffer[i] = i % 256; } while (1) __asm__("hlt"); } osbook_day03cのmain.cpp タグXのmain.cppを引用する main.cppを引用する
- 20. タグを指定して引用する //list[day02a_Main.c][EDK IIを使ったハローワールドアプリ（Main.c）][c]{ #@mapfile(../distrib/day02a/MikanLoaderPkg/Main.c) #include <Uefi.h> #include <Library/UefiLib.h> EFI_STATUS EFIAPI UefiMain( EFI_HANDLE image_handle, EFI_SYSTEM_TABLE *system_table) { Print(L"Hello, Mikan World!n"); while (1); return EFI_SUCCESS; } #@end //} ハローワールドプログラムの本体は@<tt>{Main.c}ファイルです。 @<list>{day02a_Main.c}にその全体を示します。 Re:VIEWを使った本文の例
- 21. タグ内容を抽出するツール osbook_dayNというタグに対応するソースコードを取得し distrib/dayNディレクトリに展開したい 専用ツールgit-extract-tagsを作りました https://github.com/uchan-nos/git-extract-tags 使い方 $ git extract-tags -s distrib osbook_ ../mikanos プレフィクスが「osbook_」であるタグから ファイルを抽出してdistribに書き出す legacy-free-os-book/ text/ images/ dayN.re … distrib/ dayN/ … mikanos/ MikanLoaderPkg/ kernel/ … 想定するディレクトリ構成
- 25. リベース A B C day06b D day06c master X … a バグ修正コミット リベース：Cのベースをaに付け替える A B C day06b D day06c master X … a … C’ D’ X’ 1. バグ修正を コミットする 2. リベースする
- 27. タグを付け替えるツール 元のブランチからリベース先のブランチへ各タグを移動したい 専用ツールgit-retagを作りました https://github.com/uchan-nos/git-extract-tags 使い方 $ git retag osbook_ old new プレフィクスが「osbook_」であるタグを、oldからnewへ付け替える A B C tag1 new E a B’ C’ E’ old D D’ tag2
- 28. タグ付け替えの例 「handle close button」と「exit task on window close」の間に修 正を挿入する例 挿入した修正「hoge-fix」 「osbook_dayX」というタグす べてを、「new-day30f」ブラン チに移動したい
- 30. Git rebase入門
- 31. コミットグラフを理解しよう リベース操作は複雑で分かりにくい？ コミットグラフの変化が想像できるようになれば、怖くない！ コミット：ワークツリー全体のスナップショット Diffではない ブランチ：コミットを指すラベル コミットの列、ではない A B C D master コミット ブランチ
- 33. リベース A B C D master a $ git checkout -b fix-bug B 《ワークツリーを修正》 $ git commit -a $ git rebase fix-bug master fix-bug A B master a fix-bug C’ D’
- 34. リベース（interactiveモード） 非常に多用途な git rebase -i コミットの順番を入れ替える、 不要なコミットを捨てる、 コミットメッセージを修正する、など A B C D master ここを入れ替えたいなあ…… $ git checkout master $ git rebase -i A 行を入れ替えて保存
- 35. git rebase -iのその他の機能 # Commands: # p, pick <commit> = use commit # r, reword <commit> = use commit, but edit the commit message # e, edit <commit> = use commit, but stop for amending # s, squash <commit> = use commit, but meld into previous commit # f, fixup <commit> = like "squash", but discard this commit's log message # x, exec <command> = run command (the rest of the line) using shell # b, break = stop here (continue rebase later with 'git rebase --continue') # d, drop <commit> = remove commit # l, label <label> = label current HEAD with a name # t, reset <label> = reset HEAD to a label # m, merge [-C <commit> | -c <commit>] <label> [# <oneline>] # # These lines can be re-ordered; they are executed from top to bottom. 「pick」を希望のコマンドに書き換える
- 36. コミットグラフを理解する便利なコマンド $ git log --graph --all ここで枝分かれして ここでマージされた
- 37. 間違ったリベースを無かったことにする Git reflog 「ブランチやタグ等が、過去何を指していたか」が コミットやリベース等、Gitの操作をするたびに記録される リベースなどでミスしてもデータが失われるわけではないので、 安心して実験しましょう ブランチを任意のコミットに付け直すには $ git checkout <branch> $ git reset --hard <commit>