summaryrefslogtreecommitdiff
path: root/docs/tutorial/contents.md
blob: c3279a437a568c2dc0f7eccd166424c70adff129 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# Getting started

## [Introduction to decomp](introduction.md)
- What we are doing
- Structure of the code

## Pre-decompilation
- Building the repo (follow the instructions in the README.md)
- Most of us use VSCode. (You can watch Fig's video to get an idea of how this can be used). Some useful information is [here](../vscode.md).
- Choosing a first actor (You want something small that has simple interactions with the environment. But OoT is far enough in that there are basically no unreserved actors left anyway now.)

## Decompilation

- [Begining decompilation: order, Init and the actor struct](beginning_decomp.md)
    - Order of decompilation
    - Init and common actor features
        - Initchains
        - Actors and dynapoly actors
        - Colliders
        - Skelanime

    - Matching
        - Using diff
        - control flow (branches) -> instruction ordering -> register allocation -> stack

- [The rest of the functions in the actor](other_functions.md)
    - Order of decompilation
    - Action Functions and other functions

    - More on matching: the permuter

- [Draw functions](draw_functions.md)

- [Data, migration and non-migration](data.md)
    - Importing the data: early and late
    - Fake symbols
    - Inlining

## [Object Decompilation](object_decomp.md)
- Object files
- How we decompile objects
- [Example](object_decomp_example.md)


## After Decompilation

- [Preparing to merge](merging.md)
    - Preliminary documentation
    - Preparing to PR
    - Pull Requests
    - Trello

## Appendices
- [Types, Structs and Padding](types_structs_padding.md) (a miscellany of useful stuff)
- [Helper scripts](helper_scripts.md)

To be written, maybe

- How we use git and GitHub
- Some notes on the basic structure of N64 MIPS
- Glossary
- Conventions