From b5004d26aefe4856d90f75d8114b3f64e1f73407 Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Apr 03 2018 16:34:10 +0000 Subject: making modules --- diff --git a/en-US/Using_Modules.adoc b/en-US/Using_Modules.adoc index 4863c2c..a9cff3e 100644 --- a/en-US/Using_Modules.adoc +++ b/en-US/Using_Modules.adoc @@ -1,33 +1,38 @@ = Using Modules in Fedora -NOTE: This page is a placeholder. You can make this page more useful by submitting a pull-request to https://pagure.io/fedora-docs/modularity/ +++++ + +++++ -== Enable Modularity on Fedora 28 +From the user perspective, modules are like release-independent package groups on independent lifecycles, providing alternative streams of content to Fedora. -how do you turn on the modular repo? is it there by default? +== List available modules -== Find a Module +To list all available modules and their streams, run the following command: -list & search for modules with dnf + $ dnf module list -== Discover & use installation profiles +== Install a module -dnf module info ?? are we gonna get anything better? +To install a module, use the `name:stream/profile` syntax, for example: -== Enable a Module + $ dnf module install nodejs:6/default -enable (& install?) a module +Alternatively, you can also enable a module and then install RPM packages directly: -== Your System Profile + $ dnf module enable nodejs:6 + $ dnf install nodejs -how to view the system profile, what you can change about install +== Changing a stream -== Using a module from a container +To change a stream of a module that has been already installed, use the installation command. For example: -inject a system profile with the correct versions; dnf install blah + $ dnf module install nodejs:9/default -== How to ask for a new module or stream - -enable (& install?) a module +== Module defaults +We are currently working on _system profiles_ — the defaults for your system. Thanks to these, you will need to be specific about the module, stream, or profile only when you need to. When implemented, all the following commands will also work: + $ dnf install nodejs # installs a nodejs RPM package from the default stream + $ dnf module install nodejs # installs the default profile from the default stream + $ dnf module install nodejs:9 # installs the default profile from the 9 stream