Difference between revisions of "Development Guide"

From Funtoo
Jump to: navigation, search
(Advanced Topics: make the links more visible)
m (more =)
Line 46: Line 46:
  
 
=== Advanced Topics ===
 
=== Advanced Topics ===
==[[Creating Your Own Overlay]]==
+
===[[Creating Your Own Overlay]]===
 
If you are maintaining several ebuilds for Funtoo, you may find it more convenient to maintain your own ''overlay'' and have us pull new versions of ebuilds from you, rather than having to create a pull request.
 
If you are maintaining several ebuilds for Funtoo, you may find it more convenient to maintain your own ''overlay'' and have us pull new versions of ebuilds from you, rather than having to create a pull request.
  
==[[Creating Your Own Meta-Repo and Kits]]==
+
===[[Creating Your Own Meta-Repo and Kits]]===
 
Even more advanced users may want to use our own tree update scripts to generate their own customized meta-repo and kits. This document also covers the functionality of our tree update scripts in detail, and will give you some insight into how to work with the {{c|kit-fixups}} repository effectively.
 
Even more advanced users may want to use our own tree update scripts to generate their own customized meta-repo and kits. This document also covers the functionality of our tree update scripts in detail, and will give you some insight into how to work with the {{c|kit-fixups}} repository effectively.
  
==[[Metro]]==
+
===[[Metro]]===
 
To learn how to build your own Funtoo stages, please look at documentation for [[Metro]].
 
To learn how to build your own Funtoo stages, please look at documentation for [[Metro]].
  

Revision as of 06:29, November 13, 2020

Overview

Okay, so you want to get involved. How do you do it? Well, here's how we want you to start:

Getting Started

To get started with Funtoo development, it's strongly recommended that you first watch the following video, which will introduce you to code.funtoo.org and explain how to use it to fork a repository and create a pull request. Forking a repository and creating a pull request is the best way to start doing Funtoo development:

Here is a follow-up video with close to an hour of tutorial-style instruction:

Funtoo Distinctives

To get familiar with Funtoo Linux internals, such as kit-fixups, and how they work, please be sure to read the following pages:

Ebuild Writing

To learn more about ebuilds and how to write them, the following pages are available:

For a more comprehensive reference of all the details of ebuild development, please see the Gentoo Development Manual.

Advanced Topics

Creating Your Own Overlay

If you are maintaining several ebuilds for Funtoo, you may find it more convenient to maintain your own overlay and have us pull new versions of ebuilds from you, rather than having to create a pull request.

Creating Your Own Meta-Repo and Kits

Even more advanced users may want to use our own tree update scripts to generate their own customized meta-repo and kits. This document also covers the functionality of our tree update scripts in detail, and will give you some insight into how to work with the kit-fixups repository effectively.

Metro

To learn how to build your own Funtoo stages, please look at documentation for Metro.

Pages that need updating

   Warning

These pages are stale and need updating!