From 1e3156ed4c3783cefb811027ad39cd5a05234087 Mon Sep 17 00:00:00 2001 From: Brian (bex) Exelbierd Date: Jul 28 2018 09:22:26 +0000 Subject: [PATCH 1/3] antora conversion --- diff --git a/.gitignore b/.gitignore index 462d167..9f3ebf5 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,3 @@ -## AsciiBinder-specific ignores -_preview -_package -*.swp -diag-*.png -diag-*.png.cache - -## Project-specific ignores - +build +cache +public diff --git a/Common_Content/Feedback.adoc b/Common_Content/Feedback.adoc deleted file mode 100644 index f438831..0000000 --- a/Common_Content/Feedback.adoc +++ /dev/null @@ -1,26 +0,0 @@ - -:experimental: - -== We want feedback -indexterm:[feedback,contact information for this manual] -If you find errors or have suggestions for improvement, we want your advice. Submit a report in Bugzilla against the product `{PRODUCT}` and the component `{BOOKID}`. The following link automatically loads this information for you: {BZURL}. - -In Bugzilla: - -. Provide a short summary of the error or your suggestion in the `Summary` field. - -. Copy the following template into the `Description` field and give us the details of the error or suggestion as specifically as you can. If possible, include some surrounding text so we know where the error occurs or the suggestion fits. -+ -[subs="quotes"] ----- -Document URL: - -Section number and name: - -Error or suggestion: - -Additional information: - ----- - -. Click the btn:[Submit Bug] button. diff --git a/Common_Content/Legal_Notice.adoc b/Common_Content/Legal_Notice.adoc deleted file mode 100644 index b65d4a5..0000000 --- a/Common_Content/Legal_Notice.adoc +++ /dev/null @@ -1,22 +0,0 @@ - -:experimental: - -Copyright {YEAR} {HOLDER}. - -The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at link:++http://creativecommons.org/licenses/by-sa/3.0/++[]. The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. - -Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. - -Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. - -For guidelines on the permitted uses of the Fedora trademarks, refer to link:++https://fedoraproject.org/wiki/Legal:Trademark_guidelines++[]. - -*Linux* (R) is the registered trademark of Linus Torvalds in the United States and other countries. - -*Java* (R) is a registered trademark of Oracle and/or its affiliates. - -*XFS* (R) is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. - -*MySQL* (R) is a registered trademark of MySQL AB in the United States, the European Union and other countries. - -All other trademarks are the property of their respective owners. diff --git a/Common_Content/images/title_logo.svg b/Common_Content/images/title_logo.svg deleted file mode 100644 index e8fd52b..0000000 --- a/Common_Content/images/title_logo.svg +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - - - - - - - diff --git a/README.md b/README.md deleted file mode 100644 index fd317d7..0000000 --- a/README.md +++ /dev/null @@ -1,41 +0,0 @@ -# Fedora Release Notes - -This is the content repository for the Fedora Installation Guide. - -Please report Issues and submit Pull Requests for **Content Fixes** here. General appearance issues and publishing issues should be reported against the [publisher](https://pagure.io/fedora-docs/docs-fp-o). - -## README for contributors - -Refer to https://fedoraproject.org/wiki/Category:Documentation_beats?rd=Docs/Beats -for content; proofread when adding to git and mark sections and wiki pages as -complete as you progress. - -Use `create-tx-configuration` to maintain .tx/config (thanks Sparks!) - -When shipping an RPM, test, pull POs, test again, tag, bump spec, and build. See -https://fedoraproject.org/wiki/User:Immanetize/Packaging_Docs_in_an_RPM for -detailed instructions. - -Some methods of finding new packages to write about: -https://bodhi.fedoraproject.org/updates/new -https://bodhi.fedoraproject.org/updates/?release=F25&type=newpackage -`bodhi -r f25 -t newpackage` -#~/usr/bin/env python -from fedora.client import BodhiClient; BodhiClient().query(release="F25", type_="newpackage") - -## How to edit this document - -This document is coded in AsciiDoc. The content is in the en-US directory. There is a shared entity file in the en-US directory. Do not edit the content in the Common_Content directory. - -## Testing your changes locally - -To test your changes, first install `asciibinder` - -$ gem install ascii_binder - -To build your changes, from the root directory: - -``` -$ asciibinder package -$ firefox _package/main/index.html -``` diff --git a/_distro_map.yml b/_distro_map.yml deleted file mode 100644 index 6e8a31f..0000000 --- a/_distro_map.yml +++ /dev/null @@ -1,24 +0,0 @@ ---- -fedora: - name: Fedora Release Notes - author: Fedora Documentation Project - site: main - site_name: Home - site_url: https://docs.fedoraproject.org/ - branches: - master: - name: Rawhide - dir: rawhide - f28: - name: 28 - dir: f28 -pkg: - name: Fedora Release Notes - Package Version - author: Fedora Documentation Project - site: pkg - site_name: Home - site_url: https://docs.fedoraproject.org/ - branches: - f27: - name: 27 - dir: f27 diff --git a/_images/favicon.ico b/_images/favicon.ico deleted file mode 100644 index a912017..0000000 Binary files a/_images/favicon.ico and /dev/null differ diff --git a/_images/favicon32x32.png b/_images/favicon32x32.png deleted file mode 100644 index d33bd5e..0000000 Binary files a/_images/favicon32x32.png and /dev/null differ diff --git a/_images/fedora.svg b/_images/fedora.svg deleted file mode 100644 index e8fd52b..0000000 --- a/_images/fedora.svg +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - - - - - - - diff --git a/_images/redhat-logo.png b/_images/redhat-logo.png deleted file mode 100644 index f085f1a..0000000 Binary files a/_images/redhat-logo.png and /dev/null differ diff --git a/_javascripts/.gitkeep b/_javascripts/.gitkeep deleted file mode 100644 index e69de29..0000000 --- a/_javascripts/.gitkeep +++ /dev/null diff --git a/_javascripts/bootstrap-offcanvas.js b/_javascripts/bootstrap-offcanvas.js deleted file mode 100644 index 62cf7b6..0000000 --- a/_javascripts/bootstrap-offcanvas.js +++ /dev/null @@ -1,6 +0,0 @@ -$(document).ready(function () { - $('[data-toggle="offcanvas"]').click(function () { - $('.sidebar').show(); - $('.row-offcanvas').toggleClass('active'); - }); -}); diff --git a/_stylesheets/asciibinder.css b/_stylesheets/asciibinder.css deleted file mode 100644 index a7db2eb..0000000 --- a/_stylesheets/asciibinder.css +++ /dev/null @@ -1,576 +0,0 @@ -@import url(https://maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css); -/* ------------------------------------------------------------ -Image: "Spin" https://www.flickr.com/photos/eflon/3655695161/ -Author: eflon https://www.flickr.com/photos/eflon/ -License: https://creativecommons.org/licenses/by/2.0/ ----------------------------------------------------------------*/ -.attribution { - text-align: center; - position: relative; - bottom: -20px; -} -.attribution .btn { - color: #808080; - color: rgba(175,175,175, .65); - font-size: 11px; -} -.attribution .btn:hover { - text-decoration: none; - color: #aaa; -} -.popover-content { - font-size: 12px; - line-height: 1.3; - font-weight: normal; -} - -@media screen and (max-width: 980px) { - body { - margin-bottom: 200px; - } - footer { - text-align: center; - } - footer .text-right { - text-align: center !important; - } - #footer_social .first { - margin-left: 0; - } - #footer_social > a { - top: 24px; - } -} - -.fa-inverse:hover { - color: #ccc; -} - -.collapse a.active { - background-color: #DEEAF4; - color: #000; - position: relative; -} - -.collapse a.active:hover { - text-decoration: none; -} - -.collapse a.active:before { - background-color: #A0C3E5; - content: ""; - display: inline-block; - height: 100%; - left: 0; - position: absolute; - top: 0; - width: 3px; -} - -.main h2, .main .h2 { - border-top: 0px; - padding-top: 10px; - font-size: 28px; -} - -.page-header { - height: 100% !important; -} -.page-header .img-responsive { - display: inline; -} -.page-header h2 { - font-size: 32px; - display: inline; - vertical-align: bottom; -} - -.navbar-brand { - padding: initial; - height: initial; - padding: 12px; -} - -.nav > li > a.hover{ - background-color: none; -} - -h1, h2, h3, h4, h5, h6, .h1, .h2, .h3, .h4, .h5, .h6 { - position: relative; -} - -h2 > a.anchor, h3 > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { - display: block; - font-weight: normal; - margin-left: -1.5ex; - position: absolute; - text-align: center; - text-decoration: none !important; - visibility: hidden; - width: 1.5ex; - z-index: 1001; -} - -h2 > a.anchor:before, h3 > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { - content: "\f0c1"; - display: block; - font-family: FontAwesome; - font-size: 0.7em; - -webkit-font-smoothing: antialiased; - -moz-osx-font-smoothing: grayscale; - padding-top: 0.2em; -} - -h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { - font-size: 1em; -} - -h2:hover > a.anchor, -h2 > a.anchor:hover, -h3:hover > a.anchor, -h3 > a.anchor:hover, -h4:hover > a.anchor, -h4 > a.anchor:hover, -h5:hover > a.anchor, -h5 > a.anchor:hover, -h6:hover > a.anchor, -h6 > a.anchor:hover { - visibility: visible; -} - -.main { - border-left: 1px solid #e7e7e7; - margin-left: -1px; - padding-left: 25px; -} - - -@media (min-width: 768px) { - .main { - padding-left: 30px; - } -} - -/* - * Sidebar - */ - -.nav-header { - font-size: 16px; -} - -.nav-header ul { - font-size: 14px; -} - -.nav-header ul li a { - display: block; - padding: 5px 20px 5px 25px; - font-size: 13px; - font-weight: normal; -} - -.nav-sidebar .fa { - text-align: center; - top: -1px; - width: 14px; -} - -.nav-sidebar li a { - color: inherit; -} - -.nav-sidebar li a:hover { - color: #000; -} - -.nav-sidebar ul li ul.nav-tertiary li a { - padding-left: 50px; -} - -.nav-sidebar > li > a { - padding: 7px 0; -} - -.nav-sidebar > li > a:focus, .nav-sidebar > li > a:hover { - background: transparent; -} - -.sidebar { - font-weight: 300; - display: none; - padding-top: 13px; -} - -@media screen and (max-width: 767px) { - .sidebar { - padding-left: 30px; - padding-right: 0; - } -} - -@media screen and (min-width: 768px) { - .sidebar { - border-right: 1px solid #e7e7e7; - display: block; - } -} - -/* - * Off Canvas - * -------------------------------------------------- - */ - -body, html { - overflow-x: hidden; /* Prevent scroll on narrow devices */ - font-family: "Overpass", sans-serif; -} - -.toggle-nav { - margin-right: 20px; -} - -@media screen and (max-width: 767px) { - .row-offcanvas { - position: relative; - -webkit-transition: all .25s ease-out; - -o-transition: all .25s ease-out; - transition: all .25s ease-out; - } - - .row-offcanvas-right { - right: 0; - } - - .row-offcanvas-left { - left: 0; - } - - .row-offcanvas-right - .sidebar-offcanvas { - right: -75%; /* 8 columns */ - } - - .row-offcanvas-left - .sidebar-offcanvas { - left: -75%; /* 8 columns */ - } - - .row-offcanvas-right.active { - right: 75%; /* 8 columns */ - } - - .row-offcanvas-left.active { - left: 75%; /* 8 columns */ - } - - .sidebar-offcanvas { - overflow: hidden; - position: absolute; - top: 0; - width: 75%; /* 8 columns */ - } -} - - p { - margin: 0 0 1.6em; - } - - /* Remnants of Asciidoctor default stylesheet - remove styles as needed */ - -#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; } -.left { float: left !important; } -.right { float: right !important; } -.text-left { text-align: left !important; } -.text-right { text-align: right !important; } -.text-center { text-align: center !important; } -.text-justify { text-align: justify !important; } -.hide { display: none; } -.subheader, #content #toctitle, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 1.4; color: #7a2518; font-weight: 300; margin-top: 0.2em; margin-bottom: 0.5em; } -abbr, acronym { text-transform: uppercase; font-size: 90%; color: #333333; border-bottom: 1px dotted #dddddd; cursor: help; } -abbr { text-transform: none; } -blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; } -blockquote cite { display: block; font-size: inherit; color: #454545; } -blockquote cite:before { content: "\2014 \0020"; } -blockquote cite a, blockquote cite a:visited { color: #454545; } -blockquote, blockquote p { line-height: 1.6; color: #6e6e6e; } -@media only screen and (min-width: 768px) { - #toctitle, .sidebarblock > .content > .title { line-height: 1.4; } - #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; } -} -table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; } -table thead, table tfoot { background: whitesmoke; font-weight: bold; } -table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #333333; text-align: left; } -table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #333333; } -table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; } -table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.6; } -.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; } -.clearfix:after, .float-group:after { clear: both; } -*:not(pre) > code { font-size: inherit; padding: 0; white-space: nowrap; background-color: inherit; border: 0 solid #dddddd; -webkit-border-radius: 4px; border-radius: 4px; text-shadow: none; line-height: 1; } -.keyseq { color: #666666; } -kbd:not(.keyseq) { display: inline-block; color: #333333; font-size: 0.75em; line-height: 1.4; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; margin: -0.15em 0.15em 0 0.15em; padding: 0.2em 0.6em 0.2em 0.5em; vertical-align: middle; white-space: nowrap; } -.keyseq kbd:first-child { margin-left: 0; } -.keyseq kbd:last-child { margin-right: 0; } -.menuseq, .menu { color: #1a1a1a; } -b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; } -b.button:before { content: "["; padding: 0 3px 0 2px; } -b.button:after { content: "]"; padding: 0 2px 0 3px; } -p a > code:hover { color: #561309; } -#header, #content, #footnotes, #footer { width: 100%; margin-left: auto; margin-right: auto; margin-top: 0; margin-bottom: 0; max-width: 62.5em; *zoom: 1; position: relative; padding-left: 0.9375em; padding-right: 0.9375em; } -#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; } -#header:after, #content:after, #footnotes:after, #footer:after { clear: both; } -#content:before { content: none; } -#header { margin-bottom: 2.5em; } -#header > h1 { color: black; font-weight: 300; border-bottom: 1px solid #d8d8d8; margin-bottom: -28px; padding-bottom: 32px; } -#header span { color: #6e6e6e; } -#header #revnumber { text-transform: capitalize; } -#header br { display: none; } -#header br + span { padding-left: 3px; } -#header br + span:before { content: "\2013 \0020"; } -#header br + span.author { padding-left: 0; } -#header br + span.author:before { content: ", "; } -#toc { border-bottom: 3px double #e5e5e5; padding-top: 1em; padding-bottom: 1.25em; } -#toc > ul { margin-left: 0.25em; } -#toc ul.sectlevel0 > li > a { font-style: italic; } -#toc ul.sectlevel0 ul.sectlevel1 { margin-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; } -#toc ul { font-family: "Open Sans", "DejaVu Sans", "Sans", sans-serif; list-style-type: none; } -#toc a { text-decoration: none; } -#toc a:active { text-decoration: underline; } -#toctitle { color: #7a2518; } -@media only screen and (min-width: 768px) { body.toc2 { padding-left: 15em; padding-right: 0; } - #toc.toc2 { background-color: #fafaf9; position: fixed; width: 15em; left: 0; top: 0; border-right: 1px solid #e5e5e5; border-bottom: 0; z-index: 1000; padding: 1.25em 1em; height: 100%; overflow: auto; } - #toc.toc2 #toctitle { margin-top: 0; font-size: 1.2em; } - #toc.toc2 > ul { font-size: .90em; margin-bottom: 0; } - #toc.toc2 ul ul { margin-left: 0; padding-left: 1em; } - #toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; } - body.toc2.toc-right { padding-left: 0; padding-right: 15em; } - body.toc2.toc-right #toc.toc2 { border-right: 0; border-left: 1px solid #e5e5e5; left: auto; right: 0; } } -@media only screen and (min-width: 1280px) { body.toc2 { padding-left: 20em; padding-right: 0; } - #toc.toc2 { width: 20em; } - #toc.toc2 #toctitle { font-size: 1.375em; } - #toc.toc2 > ul { font-size: 0.95em; } - #toc.toc2 ul ul { padding-left: 1.25em; } - body.toc2.toc-right { padding-left: 0; padding-right: 20em; } } -#content #toc { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-bottom: 1.25em; padding: 1.25em; background: #fafaf9; border-width: 0; -webkit-border-radius: 4px; border-radius: 4px; } -#content #toc > :first-child { margin-top: 0; } -#content #toc > :last-child { margin-bottom: 0; } -#content #toctitle { font-size: 1.375em; } -#footer { max-width: 100%; background-color: #333333; padding: 1.25em; } -#footer-text { color: #cccccc; line-height: 1.44; } -.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .verseblock, .videoblock { margin-bottom: 2.5em; } -.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left; font-family: "Noto Serif", "DejaVu Serif", "Serif", serif; font-weight: normal; font-style: italic; } -table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0; } -table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; } -.admonitionblock > table { border: 0; background: none; width: 100%; } -.admonitionblock > table td.icon { text-align: center; width: 80px; } -.admonitionblock > table td.icon img { max-width: none; } -.admonitionblock > table td.icon .title { font-weight: 300; text-transform: uppercase; } -.admonitionblock > table td.content { padding-left: 0; padding-right: 1.25em; color: #6e6e6e; } -.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; } -.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background: white; -webkit-border-radius: 4px; border-radius: 4px; } -.exampleblock > .content > :first-child { margin-top: 0; } -.exampleblock > .content > :last-child { margin-bottom: 0; } -.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6, .exampleblock > .content p { color: #333333; } -.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6 { line-height: 1; margin-bottom: 0.625em; } -.exampleblock > .content h1.subheader, .exampleblock > .content h2.subheader, .exampleblock > .content h3.subheader, .exampleblock > .content .subheader#toctitle, .sidebarblock.exampleblock > .content > .subheader.title, .exampleblock > .content h4.subheader, .exampleblock > .content h5.subheader, .exampleblock > .content h6.subheader { line-height: 1.4; } -.exampleblock.result > .content { -webkit-box-shadow: 0 1px 8px #e3e3dd; box-shadow: 0 1px 8px #e3e3dd; } -.sidebarblock { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-top: -1.0em; margin-bottom: 1.6em; margin-left: 1em; padding: .5em; background: #F1F3F5; -webkit-border-radius: 4px; border-radius: 4px; overflow-x: auto; float: right; width: 40%; } -.sidebarblock > :first-child { margin-top: 0; } -.sidebarblock > :last-child { margin-bottom: 0; } -.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6, .sidebarblock p { color: #333333; } -.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6 { line-height: 1; margin-bottom: 0.625em; } -.sidebarblock h1.subheader, .sidebarblock h2.subheader, .sidebarblock h3.subheader, .sidebarblock .subheader#toctitle, .sidebarblock > .content > .subheader.title, .sidebarblock h4.subheader, .sidebarblock h5.subheader, .sidebarblock h6.subheader { line-height: 1.4; } -.sidebarblock > .content > .title { color: inherit; font-size: 28px; font-weight: 500; margin-top: 0; line-height: 1.6; } -.width50 { width: 50% ! important} -.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; } -.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 0px; background-color: #F0F3F5; -webkit-border-radius: 5px; border-radius: 5px; padding: 1.5em 2.5em; word-wrap: break-word; } -.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; } -.literalblock pre > code, .literalblock pre[class] > code, .listingblock pre > code, .listingblock pre[class] > code { display: block; } -.listingblock > .content { position: relative; } -.listingblock:hover code[class*=" language-"]:before { text-transform: uppercase; font-size: 0.9em; color: #999; position: absolute; top: 0.375em; right: 0.375em; } -.listingblock:hover code.asciidoc:before { content: "asciidoc"; } -.listingblock:hover code.clojure:before { content: "clojure"; } -.listingblock:hover code.css:before { content: "css"; } -.listingblock:hover code.go:before { content: "go"; } -.listingblock:hover code.groovy:before { content: "groovy"; } -.listingblock:hover code.html:before { content: "html"; } -.listingblock:hover code.java:before { content: "java"; } -.listingblock:hover code.javascript:before { content: "javascript"; } -.listingblock:hover code.python:before { content: "python"; } -.listingblock:hover code.ruby:before { content: "ruby"; } -.listingblock:hover code.sass:before { content: "sass"; } -.listingblock:hover code.scss:before { content: "scss"; } -.listingblock:hover code.xml:before { content: "xml"; } -.listingblock:hover code.yaml:before { content: "yaml"; } -.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; } -.listingblock.terminal pre .command:not([data-prompt]):before { content: '$'; } -table.pyhltable { border: 0; margin-bottom: 0; } -table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; } -table.pyhltable td.code { padding-left: .75em; padding-right: 0; } -.highlight.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #d8d8d8; } -.highlight.pygments .lineno { display: inline-block; margin-right: .25em; } -table.pyhltable .linenodiv { background-color: transparent !important; padding-right: 0 !important; } -.quoteblock { margin: 0 0 1.25em 0; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; } -.quoteblock blockquote { margin: 0 0 1.25em 0; padding: 0 0 0.625em 0; border: 0; } -.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; } -.quoteblock .attribution { margin-top: -0.625em; padding-bottom: 0.625em; font-size: inherit; color: #454545; line-height: 1.6; } -.quoteblock .attribution br { display: none; } -.quoteblock .attribution cite { display: block; } -table.tableblock { max-width: 100%; } -table.tableblock td .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; } -table.spread { width: 100%; } -table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; } -table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; } -table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; } -table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; } -table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; } -table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; } -table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0; } -table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; } -table.frame-all { border-width: 1px; } -table.frame-sides { border-width: 0 1px; } -table.frame-topbot { border-width: 1px 0; } -th.halign-left, td.halign-left { text-align: left; } -th.halign-right, td.halign-right { text-align: right; } -th.halign-center, td.halign-center { text-align: center; } -th.valign-top, td.valign-top { vertical-align: top; } -th.valign-bottom, td.valign-bottom { vertical-align: bottom; } -th.valign-middle, td.valign-middle { vertical-align: middle; } -table thead th, table tfoot th { font-weight: bold; } -tbody tr th { display: table-cell; line-height: 1.6; background: whitesmoke; } -tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #333333; font-weight: bold; } -td > div.verse { white-space: pre; } -ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; } -ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; } -ul.checklist li > p:first-child > .fa-check-square-o:first-child, ul.checklist li > p:first-child > input[type="checkbox"]:first-child { margin-right: 0.25em; } -ul.checklist li > p:first-child > input[type="checkbox"]:first-child { position: relative; top: 1px; } -ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; } -ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; } -ul.inline > li > * { display: block; } -.unstyled dl dt { font-weight: normal; font-style: normal; } -ol.arabic { list-style-type: decimal; } -ol.decimal { list-style-type: decimal-leading-zero; } -ol.loweralpha { list-style-type: lower-alpha; } -ol.upperalpha { list-style-type: upper-alpha; } -ol.lowerroman { list-style-type: lower-roman; } -ol.upperroman { list-style-type: upper-roman; } -ol.lowergreek { list-style-type: lower-greek; } -.hdlist > table, .colist > table { border: 0; background: none; } -.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; } -td.hdlist1 { padding-right: .75em; font-weight: bold; } -td.hdlist1, td.hdlist2 { vertical-align: top; } -.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em; } -.colist > table tr > td:first-of-type { padding: 0 .75em; line-height: 1; } -.colist > table tr > td:last-of-type { padding: 0.25em 0; } -.qanda > ol > li > p > em:only-child { color: #1d4b8f; } -.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; } -.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0; } -.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em; } -.imageblock > .title { margin-bottom: 0; } -.imageblock.thumb, .imageblock.th { border-width: 6px; } -.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; } -.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; } -.image.left { margin-right: 0.625em; } -.image.right { margin-left: 0.625em; } -a.image { text-decoration: none; } -span.footnote, span.footnoteref { vertical-align: super; font-size: 0.875em; } -span.footnote a, span.footnoteref a { text-decoration: none; } -span.footnote a:active, span.footnoteref a:active { text-decoration: underline; } -#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; } -#footnotes hr { width: 20%; min-width: 6.25em; margin: -.25em 0 .75em 0; border-width: 1px 0 0 0; } -#footnotes .footnote { padding: 0 0.375em; line-height: 1.3; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.2em; margin-bottom: .2em; } -#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; } -#footnotes .footnote:last-of-type { margin-bottom: 0; } -#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; } -.gist .file-data > table { border: none; background: #fff; width: 100%; margin-bottom: 0; } -.gist .file-data > table td.line-data { width: 99%; } -div.unbreakable { page-break-inside: avoid; } -.replaceable { font-style: italic; font-color: inherit; font-family: inherit; } -.parameter { font-style: italic; font-family: monospace; } -.userinput { font-weight: bold; font-family: monospace; } -.envar { font-weight: bold; font-family: monospace; font-size: 90%; } -.sysitem { font-weight: bold; font-size: 90%; } -.package { font-weight: bold; font-size: 90%; } -.filename { font-weight: bold; font-style: italic; font-size: 90%; } -.big { font-size: larger; } -.small { font-size: smaller; } -.underline { text-decoration: underline; } -.overline { text-decoration: overline; } -.line-through { text-decoration: line-through; } -.aqua { color: #00bfbf; } -.aqua-background { background-color: #00fafa; } -.black { color: black; } -.black-background { background-color: black; } -.blue { color: #0000bf; } -.blue-background { background-color: #0000fa; } -.fuchsia { color: #bf00bf; } -.fuchsia-background { background-color: #fa00fa; } -.gray { color: #606060; } -.gray-background { background-color: #7d7d7d; } -.green { color: #006000; } -.green-background { background-color: #007d00; } -.lime { color: #00bf00; } -.lime-background { background-color: #00fa00; } -.maroon { color: #600000; } -.maroon-background { background-color: #7d0000; } -.navy { color: #000060; } -.navy-background { background-color: #00007d; } -.olive { color: #606000; } -.olive-background { background-color: #7d7d00; } -.purple { color: #600060; } -.purple-background { background-color: #7d007d; } -.red { color: #bf0000; } -.red-background { background-color: #fa0000; } -.silver { color: #909090; } -.silver-background { background-color: #bcbcbc; } -.teal { color: #006060; } -.teal-background { background-color: #007d7d; } -.white { color: #bfbfbf; } -.white-background { background-color: #fafafa; } -.yellow { color: #bfbf00; } -.yellow-background { background-color: #fafa00; } -span.icon > .fa { cursor: default; } -.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; cursor: default; } -.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #4E9FDD; } -.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; color: #2C8596; } -.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #ec7a08; } -.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #ec7a08; } -.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #c00; } -.conum[data-value] { display: inline-block; color: white !important; background-color: #333333; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; width: 20px; height: 20px; font-size: 12px; line-height: 20px; font-family: "Open Sans", "Sans", sans-serif; font-style: normal; font-weight: bold; text-indent: -1px; } -.conum[data-value] * { color: white !important; } -.conum[data-value] + b { display: none; } -.conum[data-value]:after { content: attr(data-value); } -pre .conum[data-value] { position: relative; top: -2px; } -b.conum * { color: inherit !important; } -.conum:not([data-value]):empty { display: none; } -.print-only { display: none !important; } -@media print { @page { margin: 1.25cm 0.75cm; } - * { -webkit-box-shadow: none !important; box-shadow: none !important; text-shadow: none !important; } - a, a:visited { color: inherit !important; text-decoration: underline !important; } - a[href^="http:"]:after, a[href^="https:"]:after { content: " (" attr(href) ")"; } - a[href^="#"], a[href^="#"]:visited, a[href^="mailto:"], a[href^="mailto:"]:visited { text-decoration: none !important; } - abbr[title]:after { content: " (" attr(title) ")"; } - pre, blockquote { page-break-inside: avoid; } - code { color: #191919; } - thead { display: table-header-group; } - tr, img { page-break-inside: avoid; } - img { max-width: 100% !important; } - p { orphans: 3; widows: 3; } - h2, h3, #toctitle, .sidebarblock > .content > .title, #toctitle, .sidebarblock > .content > .title { page-break-after: avoid; } - #toc, .sidebarblock { background: none !important; } - #toc { border-bottom: 1px solid #d8d8d8 !important; padding-bottom: 0 !important; } - .sect1 { padding-bottom: 0 !important; } - .sect1 + .sect1 { border: none !important; } - body.book #header { text-align: center; } - body.book #header > h1 { border: none !important; margin: 2.5em 0 1em 0; padding: 0; } - body.book #header span { line-height: 1.6; } - body.book #header br { display: block; } - body.book #header br + span { padding-left: 0; } - body.book #header br + span:before { content: none !important; } - body.book #toc { border: none !important; text-align: left !important; padding: 0 !important; } - #footer { background: none !important; } - #footer-text { color: #333333 !important; } - .hide-on-print { display: none !important; } - .print-only { display: block !important; } - .hide-for-print { display: none !important; } - .show-for-print { display: inherit !important; } } diff --git a/_templates/_css.html.erb b/_templates/_css.html.erb deleted file mode 100644 index 0fca7ae..0000000 --- a/_templates/_css.html.erb +++ /dev/null @@ -1,3 +0,0 @@ -<%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%> - -<%- end -%> diff --git a/_templates/_nav.html.erb b/_templates/_nav.html.erb deleted file mode 100644 index 95a7e5c..0000000 --- a/_templates/_nav.html.erb +++ /dev/null @@ -1,31 +0,0 @@ -
    - <%- navigation.each.with_index do |topic_group, groupidx| -%> - <%- current_group = topic_group[:id] == group_id -%> -
  • - - <%= topic_group[:name] %> - -
      - <%- topic_group[:topics].each.with_index do |topic, topicidx| -%> - <%- if not topic.has_key?(:topics) -%> - <%- current_topic = current_group && (topic[:id] == topic_id) -%> -
    • <%= topic[:name] %>
      • - <%- else -%> - <%- current_subgroup = topic[:id] == subgroup_id -%> -
    • - -  <%= topic[:name] %> - - -
      • - <%- end -%> - <%- end -%> -
    -
    • - <%- end -%> -
diff --git a/_templates/page.html.erb b/_templates/page.html.erb deleted file mode 100644 index 128dea8..0000000 --- a/_templates/page.html.erb +++ /dev/null @@ -1,184 +0,0 @@ - - - - - - - <%= distro %> <%= version %> | <%= [group_title, subgroup_title, topic_title].compact.join(' | ') %> - - - - - - - - - <%= render("_templates/_css.html.erb", :css_path => css_path) %> - - - - - - " rel="shortcut icon" type="text/css"> - - - - - -
-

- -

-
    -
  1. - <%= site_name %> -
    2. - - - <%= breadcrumb_subgroup_block %> - -
-
-
- <%= render("_templates/_nav.html.erb", :navigation => navigation, :group_id => group_id, :topic_id => topic_id, :subgroup_id => subgroup_id, :subtopic_shim => subtopic_shim) %> -
-
-
-

<%= article_title %>

-
- <%= content %> -
-
-
-
-
-
-
-
-

About

-
-
-
About Fedora
-
Sponsors
-
Fedora Magazine
-
Legal
-
-
    -
  • - -
    • -
  • - -
    • -
  • - -
    • -
-
-
- -
-

Download

-
-
-
Get Fedora Workstation
-
Get Fedora Server
-
Get Fedora Atomic
-
Fedora Spins
-
Fedora Labs
-
Fedora ARM®
-
Alternative Downloads
- -
-
-
- -
-

Support

-
-
-
Get Help
-
Ask Fedora
-
Common Bugs
-
Fedora Developer Portal
-
Installation Guide
-
-
-
- -
-

Join

-
-
-
Join Fedora
-
Planet Fedora
-
Fedora SIGs
-
Fedora Account System
-
Fedora Community
-
-
-
-
- -
-
-
- " alt="Red Hat Logo" /> -
-
-
-
- - -

© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the documentation team

-
-
-
- -
-
-
- - - - - - - - diff --git a/_topic_map.yml b/_topic_map.yml deleted file mode 100644 index c57948b..0000000 --- a/_topic_map.yml +++ /dev/null @@ -1,98 +0,0 @@ -# This configuration file dictates the organization of the topic groups and -# topics on the main page of the doc site for this branch. Each record -# consists of the following: -# -# --- <= Record delimiter -# Name: Origin of the Species <= Display name of topic group -# Dir: origin_of_the_species <= Directory name of topic group -# Topics: -# - Name: The Majestic Marmoset <= Topic name -# File: the_majestic_marmoset <= Topic file under group dir +/- -# - Name: The Curious Crocodile <= Topic 2 name -# File: the_curious_crocodile <= Topic 2 file -# - Name: The Numerous Nematodes <= Sub-topic group name -# Dir: the_numerous_nematodes <= Sub-topic group dir -# Topics: -# - Name: The Wily Worm <= Sub-topic name -# File: the_wily_worm <= Sub-topic file under / -# - Name: The Acrobatic Ascarid <= Sub-topic 2 name -# File: the_acrobatic_ascarid <= Sub-topic 2 file under / -# -# The ordering of the records in this document determines the ordering of the -# topic groups and topics on the main page. ---- -Name: Fedora Release Notes -Dir: en-US -Topics: - - Name: Book Information - File: index - - Name: Welcome to Fedora - Dir: welcome - Topics: - - Name: Welcome to Fedora - File: Welcome - - Name: Overview - File: Overview - - Name: Hardware Overview - File: Hardware_Overview - - Name: Feedback - File: Feedback - - Name: Changes in Fedora for System Administrators - Dir: sysadmin - Topics: - - Name: Fedora Add-On Modularity - File: Modularity - - Name: Kernel - File: Kernel - - Name: Installation - File: Installation - - Name: Security - File: Security - - Name: Automation - File: Automation - - Name: Virtualization - File: Virtualization - - Name: Mail Servers - File: Mail_Servers - - Name: X.Org - File: Xorg - - Name: System Utilities - File: System_Utilities - - Name: Changes in Fedora for Desktop Users - Dir: desktop - Topics: - - Name: Desktop - File: Desktop - - Name: Networking - File: Networking - - Name: Internationalization - File: I18n - - Name: Changes in Fedora for Developers - Dir: developers - Topics: - - Name: Development Tools - File: Development_Tools - - Name: C - File: Development_C - - Name: Containers - File: Containers - - Name: Boost - File: Development_Boost - - Name: D - File: Development_D - - Name: Erlang - File: Development_Erlang - - Name: Go - File: Development_Go - - Name: Haskell - File: Development_Haskell - - Name: Python - File: Development_Python - - Name: Ruby - File: Development_Ruby - - Name: Rust - File: Development_Rust - - Name: Web Development - File: Development_Web - - Name: Revision History - File: Revision_History diff --git a/antora.yml b/antora.yml new file mode 100644 index 0000000..b94b196 --- /dev/null +++ b/antora.yml @@ -0,0 +1,3 @@ +--- +name: fedora +version: f28 diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..c9349e3 --- /dev/null +++ b/build.sh @@ -0,0 +1,16 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + docker run --rm -it -v $(pwd):/antora antora/antora --html-url-extension-style=indexify site.yml + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." +sudo docker run --rm -it -v $(pwd):/antora:z antora/antora --html-url-extension-style=indexify site.yml +fi diff --git a/en-US/Author_Group.adoc b/en-US/Author_Group.adoc deleted file mode 100644 index b7ff345..0000000 --- a/en-US/Author_Group.adoc +++ /dev/null @@ -1 +0,0 @@ -.The Fedora Docs Team diff --git a/en-US/Revision_History.adoc b/en-US/Revision_History.adoc deleted file mode 100644 index 577e4fb..0000000 --- a/en-US/Revision_History.adoc +++ /dev/null @@ -1,10 +0,0 @@ - -include::en-US/entities.adoc[] - -[[appe-Release_Notes-Revision_History]] -= Revision History - -`26.01-3`:: Sun Jul 30 2017, (docs AT lists.fedoraproject.org), First AsciiDoc version. - -`26.01-2`:: Tue Jul 11 2017, (docs AT lists.fedoraproject.org) - diff --git a/en-US/desktop/Desktop.adoc b/en-US/desktop/Desktop.adoc deleted file mode 100644 index e5c08f9..0000000 --- a/en-US/desktop/Desktop.adoc +++ /dev/null @@ -1,22 +0,0 @@ -include::en-US/entities.adoc[] - -[[sect-desktop]] -= Desktop - -[[sect-desktop-librealsense]] -== librealsense2 - -A new version of librealsense has been released to support new models of RealSense cameras. -The librealsense library will be upgraded to the new release. The previous version of the library will be changed to librealsense1 to support older model RealSense cameras. - -New Cameras supported by the updated version of librealsense library include: D400, D410, D415, D420, D430, D435, D4m. - -Older Cameras that can be supported by the previous library now named librealsense1: R200, F200, SR300, LR200, ZR300 -For more information about librealsense please visit their github page: link++:https://github.com/IntelRealSense/librealsense/++[https://github.com/IntelRealSense/librealsense] - -[[sect-desktop-sugar]] -== Sugar 0.112 - -Sugar is a free and open-source desktop environment designed for interactive learning by children. -In Fedora 28, Sugar has been updated to version 0.112. -Information about the new features in Sugar is available in the https://wiki.sugarlabs.org/go/0.112[Sugar 0.112 release notes]. diff --git a/en-US/desktop/I18n.adoc b/en-US/desktop/I18n.adoc deleted file mode 100644 index f035125..0000000 --- a/en-US/desktop/I18n.adoc +++ /dev/null @@ -1,31 +0,0 @@ -include::en-US/entities.adoc[] - -:experimental: - -[[sect-i18n]] -= Internationalization - -[[sect-i18n-ibus]] -== IBus 1.5.18 - -* IBus core package has provided an emoji dialog which can be launched with kbd:[Ctrl+Shift+E] shortcut key footnote:[The shortcut key can be customized with `ibus-setup` utility] and the emoji dialog now accepts Unicode names besides emoji annotations. _E.g. "`a with grave`" shows *À* (I.E. U+00C0)._ footnote:[To insert the space, kbd:[Shift+Space] key is avaiable.] -* When you open "`Open Unicode choice`" on the emoji category list of the emoji dialog, The Unicode name list is open. -* In the previous releases, the shortcut key kbd:[Ctrl+Shift+E] was not available in GNOME desktop environment but the shortcut key is now available in any desktop environmets. However to enable the shortcut key in GNOME, you have to add one more IBus input method sources besides XKB sources with `gnome-control-center region` utility. _E.g. If you have "`English (US)`" and "`French`", you also need to add "`English (English – US (Typing Booster))`" or "`Other (rawcode)`" or "`Chinese (Intelligent Pinyin)`" or else so that you apply IBus engines to "`English (US)`" and "`French`" XKB sources._ -* kbd:[PageUp], kbd:[PageDown], kbd:[Ctrl+Shift+N], kbd:[Ctrl+Shift+P] keys are now available to shift pages on the Unicode name list. - -To get furthermore infomation, refer https://desktopi18n.wordpress.com/2018/03/06/ibus-1-5-18-is-released/ - -[[sect-i18n-fontconfig]] -== fontconfig 2.13 - -The fontconfig package is updated to the version 2.13 which contains the following features and bug fixes: - - * config file description support - * allow sharing caches under the bind-mounted dirs - * improve footprint on creating caches - * variable fonts support - -[[sect-i18n-glibc]] -== Glibc collation update and sync with CLDR - -The collation data in glibc is extremely out of date, most locales base their collation rules on an iso14651_t1_common file which has not been updated for probably more than 15 years. Therefore, all characters added in later Unicode versions are missing and not sorted at all which causes bugs like [Bug 1336308 - Infinite (∞) and empty set (∅) are treated as if they were the same character by sort and uniq]. This change is about updating that iso146541_t1_common file to the latest available version from ISO which is from 2016 and up-to-date with Unicode 9.0.0. Because additions and changes in the syntax of the new iso146541_t1_common file, updating that file requires changing the collation rules of almost all locales. Because all these collation rules have to be touched anyway, this is a good opportunity to fix bugs in the collation ruies and sync them with the collation rules in CLDR. diff --git a/en-US/desktop/Networking.adoc b/en-US/desktop/Networking.adoc deleted file mode 100644 index 2e1f216..0000000 --- a/en-US/desktop/Networking.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-networking]] -= Networking diff --git a/en-US/developers/Containers.adoc b/en-US/developers/Containers.adoc deleted file mode 100644 index 02550c4..0000000 --- a/en-US/developers/Containers.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-containers]] -= Containers diff --git a/en-US/developers/Development_Boost.adoc b/en-US/developers/Development_Boost.adoc deleted file mode 100644 index 4f39773..0000000 --- a/en-US/developers/Development_Boost.adoc +++ /dev/null @@ -1,16 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-boost]] -= Boost - -== Fedora 28 Boost 1.66 upgrade -*Boost* has been upgraded to version 1.66. Apart from a number of bugfixes and improvements to existing libraries, this brings several new libraries compared to Fedora 27: `Boost.PolyCollection`, `Boost.Stacktrace`, `Boost.Beast`, `Boost.CallableTraits`, `Boost.Mp11`. - -One library has been removed, `Boost.TR1`, and a number of deprecated APIs in `Boost.Asio` have been removed. Code using `Boost.TR1` should be modified to use the equivalent features provided by other Boost libraries (e.g. `Boost.Tuple`, `Boost.Unordered`) or in the C++ standard library (e.g. `std::tuple`, `std::unordered_map`). Code using the deprecated Asio APIs should be modified by removing the `io_service` arguments. - -You can find full lists of changes compared to Fedora 27 in upstream release notes: - -* link:++http://www.boost.org/users/history/version_1_66_0.html++[1.66 release notes] -* link:++http://www.boost.org/users/history/version_1_65_1.html++[1.65.1 release notes] -* link:++http://www.boost.org/users/history/version_1_65_0.html++[1.65 release notes] diff --git a/en-US/developers/Development_C.adoc b/en-US/developers/Development_C.adoc deleted file mode 100644 index 49a9831..0000000 --- a/en-US/developers/Development_C.adoc +++ /dev/null @@ -1,38 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-c]] -= C - -[[sect-c-sunrpc]] -== Sun RPC Interfaces Moved From glibc To libtirpc - -Fedora 28 now uses https://sourceforge.net/projects/libtirpc/[libtirpc] to implement the Sun RPC protocol. - -The glibc imlementation of Sun RPC was not compatible with IPv6 and adding IPv6 support would have required a change to the glibc ABI. -As a result, the Sun RPC implementation was moved to a separate library, libtirpc, which has been packaged in Fedora since Fedora 7. -Sun RPC support in glibc has been deprecated for a long time and this change aligns Fedora with the upstream projects. - - -== Libcrypt replaced by libxcrypt in glibc - -In reaction to plans to remove the *libcrypt* library from *glibc*, this update replaces *libcrypt* in Fedora's version of *glibc* with the *libxcrypt* library. The use of the *libxcrypt* library allows easier integration of new hashing algorithms, promises the benefits of a faster development cycle than *libcrypt*, and provides support for all hashing algorithms ever introduced to the `crypt()` function. - - -[discrete] -=== Compatibility - -The *libxcrypt* library is backwards binary compatible with `libcrypt.so.1` shipped as a part of the GNU{nbsp}C Library. Therefore, all binaries built against *libcrypt* should work without modifications with `libcrypt.so.1` provided by *libxcrypt*. It is, however, not possible to recompile programs that use the following legacy APIs supplied by *libcrypt* against *libxcrypt*: `encrypt`, `encrypt_r`, `setkey`, `setkey_r`, and `fcrypt`. - -There is, also, no reverse compatibility. Therefore, binaries linked against `libcrypt.so.1` provided by *libxcrypt* will not work with *glibc*'s default *libcrypt*. - -To list all packages built against *libcrypt*, run the following command: - ----- -sudo dnf repoquery --whatrequires 'libcrypt.so*' | sed -e 's!-[0-9]\+.*$!!g' | sort -u ----- - -== The GNU C Library version 2.27 -Fedora 28 provides the GNU C Library (*glibc*) version 2.27. - -See the link:++https://sourceware.org/ml/libc-announce/2018/msg00000.html++[release announcement] for full information about changes brought by this version, and the link:++https://sourceware.org/glibc/wiki/Release/2.27#Packaging_Changes++[glibc wiki entry about this release] which contains a section on packaging changes. Also note the separate change related to *glibc* described in <>. diff --git a/en-US/developers/Development_D.adoc b/en-US/developers/Development_D.adoc deleted file mode 100644 index c79c14b..0000000 --- a/en-US/developers/Development_D.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-d]] -= D diff --git a/en-US/developers/Development_Erlang.adoc b/en-US/developers/Development_Erlang.adoc deleted file mode 100644 index f1b9b79..0000000 --- a/en-US/developers/Development_Erlang.adoc +++ /dev/null @@ -1,27 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-erlang]] -= Erlang - -[[sect-erlang-erlang20]] -== Erlang 20 - -Erlang/OTP has been updated to version 20. -Highlights from the changes introduced in v20 include: - -- so-called 'dirty schedulers' are available on systems with SMP; -- atoms may now contain arbitrary Unicode characters (for example, 'здравствуй-你好'); -- Erlang applications can now handle some OS signals (SIGHUP, for example); -- improved unicode support for strings; -- the zlib module has been refactored and all its operations will now yield appropriately, allowing them to be used freely in concurrent applications. - -Fedora's Erlang package maintainers have also improved the integration of Erlang with the rest of the system. -Erlang developers can now benefit from: - -- improved logging to journald; -- access to D-Bus from the erlang-dbus package; -- improved Erlang Packaging Guidelines. - -More information about the changes in Erlang is available from the https://www.erlang.org/news[Erlang website]. -More information about the improved integration into Fedora is available from the Fedora https://fedoraproject.org/wiki/Changes/Erlang_20[change description]. diff --git a/en-US/developers/Development_Go.adoc b/en-US/developers/Development_Go.adoc deleted file mode 100644 index c3f0823..0000000 --- a/en-US/developers/Development_Go.adoc +++ /dev/null @@ -1,10 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-development-go]] -= Go - - -== Golang rebased to 1.10 - -With this update, Golang packages have been rebased to version 1.10. The new version offers performance improvements, support for new instructions, new features, and bugfixes. See link:https://tip.golang.org/doc/go1.10[] for a detailed list of all changes in version 1.10. All dependent packages have been rebuilt. diff --git a/en-US/developers/Development_Haskell.adoc b/en-US/developers/Development_Haskell.adoc deleted file mode 100644 index 2963d95..0000000 --- a/en-US/developers/Development_Haskell.adoc +++ /dev/null @@ -1,15 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-haskell]] -= Haskell - -== GHC 8.2 -Fedora 28 brings version 8.2.2 of the *GHC* Haskell compiler. - -For full information about new features and bug fixes in this update, see the upstream release notes at: - -* link:++https://downloads.haskell.org/~ghc/8.2.2/docs/html/users_guide/8.2.1-notes.html++[8.2.1 Release Notes] -* link:++https://downloads.haskell.org/~ghc/8.2.2/docs/html/users_guide/8.2.2-notes.html++[8.2.2 Release Notes] - -If you want to migrate your applications from GHC 8.0 to this version, see the link:++https://ghc.haskell.org/trac/ghc/wiki/Migration/8.2++[upstream migration guide]. diff --git a/en-US/developers/Development_Python.adoc b/en-US/developers/Development_Python.adoc deleted file mode 100644 index 2f978b0..0000000 --- a/en-US/developers/Development_Python.adoc +++ /dev/null @@ -1,26 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-python]] -= Python - -[[sect-python-kerberos]] -== Kerberos in Python Modernization - -There is https://fedoraproject.org/wiki/Changes/kerberos-in-python-modernization[an ongoing project] to replace `python-krbV` and `pykerberos` with `python-gssapi` in all Fedora packages. -`python-gssapi` uses the GSSAPI interface, which is widely standardized, implemented by both MIT and Heimdal Kerberos, and much more user-friendly. - -None of the packages has been removed in Fedora 28 but the following packages should be considered as deprecated: - -* python{2,}-kerberos -* python2-krbV -* python-urllib2_kerberos -* python{2,}-requests-kerberos - -[[sect-python-generators]] -== Python Module Dependency Generation - -Fedora 28 introduces the ability to use an automated Python module dependency generator for packages that provide Python Egg/Wheel metadata. -Automatic generation of Provides has been enabled in Fedora since Jun 2016. -As a result, all packages that include egg/wheel metadata now have their Provides entries added automatically. -With this release, packagers are able to take advantage of automatic generation of Requires entries, removing the need to specify runtime dependencies manually. diff --git a/en-US/developers/Development_Ruby.adoc b/en-US/developers/Development_Ruby.adoc deleted file mode 100644 index 76458ca..0000000 --- a/en-US/developers/Development_Ruby.adoc +++ /dev/null @@ -1,24 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-ruby]] -= Ruby - -== Ruby 2.5 -Ruby 2.5 is the latest stable version of Ruby. Many new features and improvements are included for the increasingly diverse and expanding demands for Ruby. With this major update from Ruby 2.4 in Fedora 26 to Ruby 2.5 in Fedora 28, Fedora becomes the superior Ruby development platform. - -New features: - -* `rescue`/`else`/`ensure` are now allowed to be used directly with `do`/`end` blocks. -* Add `yield_self` to yield given block in its context. Unlike `tap`, it returns the result of the block. -* Support branch coverage and method coverage measurement. The branch coverage indicates which branches are executed and which are not. The method coverage indicates which methods are invoked and which are not. By running a test suite with these new features, you will know which branches and methods are executed, and evaluate total coverage of the test suite more strictly. -* `Hash#slice` and `Hash#transform_keys`. -* `Struct.new` can create classes that accept keyword arguments. -* Enumerable `#any?`, `all?`, `none?`, and `one?` accept a pattern argument. -* Top-level constant look-up is no longer available. -* One of our most loved libraries, `pp.rb`, is now automatically loaded. You no longer have to write require `pp`. -* Print backtrace and error message in reverse order (oldest call first, most recent call last). When a long backtrace appears on your terminal (TTY), you can easily find the cause line at the bottom of the backtrace. Note that the order is reversed only when the backtrace is printed out to the terminal directly. - -The source level compatibility with previous versions of Ruby should be preserved. Nevertheless, user specific Ruby binary extensions need to be rebuild. - -See the link:++https://github.com/ruby/ruby/blob/v2_5_0/NEWS++[upstream release notes] for more information about Ruby 2.5. diff --git a/en-US/developers/Development_Rust.adoc b/en-US/developers/Development_Rust.adoc deleted file mode 100644 index 403ec03..0000000 --- a/en-US/developers/Development_Rust.adoc +++ /dev/null @@ -1,12 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-rust]] -= Rust - -[[sect-rust-packaging]] -== Packaging Rust Applications and Libraries - -Fedora is one of the first distributions to package software written in the Rust programming language. -Fedora 28 includes the tools and instructions necessary to package applications and libraries written in Rust. -As a result, users will be able to install software developed in Rust (for example, *ripgrep*) from the Fedora repositories. diff --git a/en-US/developers/Development_Tools.adoc b/en-US/developers/Development_Tools.adoc deleted file mode 100644 index 7e5737c..0000000 --- a/en-US/developers/Development_Tools.adoc +++ /dev/null @@ -1,43 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-development-tools]] -= Development Tools - - -== GCC 8.1 - -Fedora 28 comes with *GCC 8.1* as the primary compiler. See link:http://gcc.gnu.org/gcc-8/changes.html[] for user-visible changes in the new version. - - -== Binutils rebased to 2.29.1 - -The *binutils* collection of tools has been rebased from version 2.29 to 2.29.1. This minor release does not introduce any new features, but it includes a number of important bug fixes. In addition, the default build flags have been changed to include `-z defs`, so that undefined symbols result in errors. The benefit is that this prevents shipping dynamic shared objects (DSO) that are not correctly linked because they refer to versioned symbols as plain undefined symbols without specifying a symbol version. - -[[sect-development-tools-]] -== Hardening Flags Updates - -Fedora 28 has been built with updated hardening flags, as provided by the GNU toolchain. -Compared to previous releases, the following changes have been made to the way programs are built: - -* Stack clash protection is enabled. -* Lightweight assertions have been switched on in the C++ standard run-time library. -* On x86-64, binaries have been built in such a way that they will support Control Flow Enforcement Technology (CET) in the future. -* On systems which support memory protection keys, lazy binding now uses a read-only GOT. -* By default the toolchain generates PIE executables to further harden Fedora executables from attacks. - -[[sect-ldconfig-scriptlets]] -== Removing ldconfig Scriptlets - -Packages in Fedora repositories included calls to ldconfig in `%post` and `%postun` sections of the spec file if they package shared libraries. -With Fedora 28, packages can use _file triggers_, which allow faster installation of packages as `ldconfig` is run only once per transaction. - -NOTE: If your package places shared libraries in special locations referenced by `ld.so.conf`, you still need to run `ldconfig` manually. - -More information about this change can be found on related https://fedoraproject.org/wiki/Changes/Removing_ldconfig_scriptlets[Fedora change page]. -[[sect-mingw-debuginfo]] - -== DebugInfo Included by Default in MinGW Binaries - -MinGW binaries contain symbol names by default to allow for easier debugging of Windows applications cross-compiled from Fedora. -Full debug information is still available in the `debuginfo` packages. diff --git a/en-US/developers/Development_Web.adoc b/en-US/developers/Development_Web.adoc deleted file mode 100644 index eb8fca4..0000000 --- a/en-US/developers/Development_Web.adoc +++ /dev/null @@ -1,21 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-web-development]] -= Web Development - -== PHP 7.2 -Fedora 28 provides PHP 7.2. - -As the list of changes is too extensive to cover in this document, and at the same time all changes are documented upstream, you are encouraged to read the link:++http://www.php.net/ChangeLog-7.php#7.2.0++[upstream changelog] and link:++https://raw.githubusercontent.com/php/php-src/PHP-7.2/UPGRADING++[upgrade notes]. A link:++http://php.net/manual/en/migration72.php++[migration guide] is also available to anyone wishing to migrate from version 7.1. - -== Django 2.0 -Fedora 28 provides versin 2.0 of the *Django* framework. Notable changes include: - -* Simplified routing syntax -* Mobile-friendly administration interfaces -* Brand new Windows expressions - -*Django 2.0* only supports *Python 3*, support for *Python 2* has been dropped. If you previously used _python2-django_ from a RPM package, make sure you use _python3-django_ and run your code on *Python 3*. A backward compatible package, _python2-django1.11_, is also provided for cases where migration to Python 3 is not possible. - -See the link:++https://docs.djangoproject.com/en/2.0/releases/2.0/++[upstream release notes] for a full list of changes in this release. diff --git a/en-US/entities.adoc b/en-US/entities.adoc deleted file mode 100644 index 3e067dd..0000000 --- a/en-US/entities.adoc +++ /dev/null @@ -1,10 +0,0 @@ -:BOOKID: release-notes -:BZURL: https://pagure.io/release-notes -:COMMONBUGS_URL: http://fedoraproject.org/wiki/Common_F28_bugs -:HOLDER: Fedora Project Contributors -:KERNEL: 4.8 -:NEXTVER: Rawhide -:PREVVER: 27 -:PRODUCT: Fedora Documentation -:PRODVER: 28 -:YEAR: 2018 diff --git a/en-US/index.adoc b/en-US/index.adoc deleted file mode 100644 index 14ed05f..0000000 --- a/en-US/index.adoc +++ /dev/null @@ -1,16 +0,0 @@ - -include::en-US/entities.adoc[] - -= Release Notes - -Release Notes for Fedora {PRODVER} - -[abstract] --- -This document provides the release notes for Fedora {PRODVER}. It describes major changes offered as compared to Fedora {PREVVER}. --- - -image:../../Common_Content/images/title_logo.svg[Fedora Logo] -include::Common_Content/Legal_Notice.adoc[] - -include::en-US/Author_Group.adoc[] diff --git a/en-US/sysadmin/Automation.adoc b/en-US/sysadmin/Automation.adoc deleted file mode 100644 index 11f1fd2..0000000 --- a/en-US/sysadmin/Automation.adoc +++ /dev/null @@ -1,14 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-automation]] -= Automation - -[[sect-automation-facter]] -== Facter 3 - -Facter is *Puppet’s* cross-platform system profiling library. -Fedora 28 updates the `facter` package from v2.x to v3.x. -The `ruby-facter` package must also be installed for any *Ruby* application or script to make use of the facter library. - -More information about the scope of the change is in the upstream https://docs.puppet.com/facter/3.0/release_notes.html[Facter 3 release notes]. diff --git a/en-US/sysadmin/Installation.adoc b/en-US/sysadmin/Installation.adoc deleted file mode 100644 index 9e8a52a..0000000 --- a/en-US/sysadmin/Installation.adoc +++ /dev/null @@ -1,41 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-installation]] -= Installation -This section describes changes in the *Anaconda* installer. - -== Anaconda modularization effort -*Anaconda* is going through a large scale effort to modularize its internals. (Note that this effort is separate from the _Fedora_ modularization effort described in <>.) The following changes have been made to *Anaconda*: - -* Modules have been added which are separate *Python* processes. They are connected to the main *Anaconda* process using *DBus*. -* Most Kickstart commands are now processed on separate modules, and used in the UI in many places as backend data sources. - -The modularization effort has no visible impact on the user experience. To read more about the installer internals, see the link:++https://rhinstaller.wordpress.com/++[installer team's blog]. - -== Kickstart changes -* The `authconfig` command has been deprecated by `authselect`. - -== Changes in boot options -New boot options: - -* `inst.stage2.all` - With this boot option, the stage 2 image will be fetched from HTTP, HTTPS and FTP locations which are specified using the `inst.stage2=` option sequentially in the order they are specified, until the image is successfully fetched. All other locations will be ignored. -* `inst.ks.all` - With this boot option, the Kickstart file will be fetched from HTTP, HTTPS and FTP locations which are specified using the `inst.ks=` option sequentially in the order they are specified, until the file is successfully fetched. All other locations will be ignored. -* `inst.xtimeout=` - Specifies a timeout period (in seconds) the installer will wait before starting the *X* server. - -== Reduced initial setup redundancy -When you install the _Workstation_ variant of Fedora 28 using the live image, you will now be prompted to create a user account by *GNOME Initial Setup* instead of Anaconda. Additionally, you will no longer be prompted to set a root password during the installation of Fedora Workstation using the live image. The `root` account will be disabled by default; you can enable it by setting a password for it using the `sudo passwd` command. If you do not reenable the `root` account, you can still perform any administrative tasks using `sudo` and your user password. - -These changes have been made in order to reduce redundancy between **Anaconda**, **Initial Setup**, and **GNOME Initial Setup**, which could previously all ask you to perform the same setup tasks. - -== Miscellaneous changes - -* Former dependencies of the _anaconda_ package itself have been separated into the _anaconda-install-env-deps_ package. -* The number of dependencies for *Initial Setup* has been massively decreased, which enables it to run on systems with a significantly lower amount of memory than before. -* Anaconda now enables hibernation by default on AMD and Intel (x86) systems. -* The progress bar displayed while the installation is in progress is now more accurate. -* The `pykickstart` and `blivet` libraries, which are used to handle Kickstart processing and storage configuration respectively, have been both upgraded to version `3`. -* Payload is usable usable in `InstallClass` -* You can now add sources in `InstallClass` -* `InstallClass` is now selected at runtime based on the `.buildstamp` file. -* `InstallClass` can now specify a Fedora variant which it should run on. This is defined by the `Variant` item in the `.buildstamp` file. diff --git a/en-US/sysadmin/Kernel.adoc b/en-US/sysadmin/Kernel.adoc deleted file mode 100644 index 929d045..0000000 --- a/en-US/sysadmin/Kernel.adoc +++ /dev/null @@ -1,27 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-kernel]] -= Kernel - -[[sect-kernel-battery]] -== Improved Laptop Battery Life - -Fedora 28 enables https://fedoraproject.org/wiki/Changes/ImprovedLaptopBatteryLife[a number of power saving features] by default for the first time. -The changes are in base packages and so all users will automatically gain these improvements upon upgrading. -As a result, laptops running Fedora will be able to last longer on battery power. - -== Thunderbolt enablement - -Fedora 28 adds support for Thunderbolt - an interface developed by Intel which allows connection of external peripherals to a computer. - -Devices connected via Thunderbolt are DMA masters, which means they can read system memory directly without interference from the computer's operating system or even CPU. To mitigate the security risk this type of access poses, there are four available security levels for communication, which are set by system firmware: - -* `none` - security is disabled, all devices are fully functional when connected -* `dponly` - only pass the DisplayPort stream through to the connected device -* `user` - connected devices must be manually authorized by the user -* `secure` - same as `user`, but also verify the device's identy through a secret key - -Starting with version 4.13, the Linux kernel provides an interface through `sysfs` which enables userspace query about the security level, the status of any connected devices, and to authorize devices if the security level demands it. The active security level must normally be selected before booting via a BIOS/EFI option, but it is interesting to note that the `none` option will likely be removed in the future. This would mean that connected Thunderbolt devices would not work unless authorized by the user from within the running operating system. - -For this reason, Fedora 28 implements full Thunderbolt 3 support. In order to avoid compromising the security, there are two userspace components working together to enable Thunderbolt: a system service (link:++https://src.fedoraproject.org/rpms/bolt++[`boltd`]) and a component in *GNOME Shell*. The shell component will automatically enroll (authorize and store in an internal database) any new connected devices using `boltd` only if the current user is an administrator and if the session is unlocked. After the device has been authorized once, its information is stored in the database and it will be authorized automatically on subsequent connections. diff --git a/en-US/sysadmin/Mail_Servers.adoc b/en-US/sysadmin/Mail_Servers.adoc deleted file mode 100644 index bfe7e71..0000000 --- a/en-US/sysadmin/Mail_Servers.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-mail-servers]] -= Mail Servers diff --git a/en-US/sysadmin/Modularity.adoc b/en-US/sysadmin/Modularity.adoc deleted file mode 100644 index 09ef8be..0000000 --- a/en-US/sysadmin/Modularity.adoc +++ /dev/null @@ -1,42 +0,0 @@ - -include::en-US/entities.adoc[] - -[[select-modularity]] -= Fedora Add-On Modularity - -link:++https://docs.pagure.org/modularity/++[Fedora Modularity] introduces an optional Modular repository that provides additional versions of software on independent lifecycles.  - -Users can now keep their operating system up-to-date while having the right version of an application for their use case, even when the default version in the distribution changes. - -[[select-modularity-features]] -== Features - -This change introduces three *new optional repositories for additional versions of software* delivered as module streams. - -Modules are collection of packages representing an application, a language stack, or a collection of package that make sense to be delivered together. An example could be a nodejs module. - -Streams are series of versions that are backwards compatible. An example could be two streams of nodejs — version 6.x and version 8.x compatible. - -*Client tooling (DNF) has been improved to be able to manage multiple streams of software*. Users can choose the right stream for their use case and DNF makes sure that: - -* The right versions of packages get installed. -* Updating the system also updates the packages within the module streams to their latest versions. -* Updating the system will never cause a module to skip to another stream, even when there are newer versions available. Changing streams is always a conscious decision the user explicitly makes. - -Should users choose not to bother with modules and streams, they always get the distribution default. This means that modularity can be used without any changes to the existing workflows. - -Also, *upgrading an existing Fedora installation won’t require any special steps* as there are no changes to the main Fedora repository. The new content is in a separate repository that is completely optional. - -[[select-modularity-benefits]] -== What are the benefits? - -Different users have different needs. Developers want the latest versions possible, system administrators want stability for longer period of time. - -Modularity makes some parts of the system to move slowly, and other parts to move faster — so users can choose the right speed of different parts according to their use case. - -[[select-modularity-next-steps]] -== Next steps - -Modules can have independent lifecycles from the base Fedora release. Starting next release, it will be possible to build modules against multiple Fedora releases thanks to the link:++https://fedoraproject.org/wiki/Infrastructure/Factory2/Focus/StreamExpansion++[Stream Expansion functionality]. - -That means users will be able to upgrade to the new Fedora version while keeping the streams of software they need for their applications. This will be particularly useful for Fedora Server. \ No newline at end of file diff --git a/en-US/sysadmin/Security.adoc b/en-US/sysadmin/Security.adoc deleted file mode 100644 index ed3fcc1..0000000 --- a/en-US/sysadmin/Security.adoc +++ /dev/null @@ -1,71 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-security]] -= Security - - -== Updated cryptography settings - -With this update, the default Fedora policy regarding cryptographic components has been updated to disallow the use of algorithms that are no longer considered secure. Specifically, the changes involve: - -* Require RSA of 2048 bits or more -* Disable DSA - - -== Libcurl switches from libssh2 to libssh - -With this update, the *libcurl* library switches from using *libssh2* to implement the SSH layer of SCP and SFTP protocols to *libssh*. The reason for the change is that the *libssh2* library uses outdated cryptographic algorithms and lacks important features, such as GSS-API authentication. The newly used *libssh* library is more secure, feature-complete, and with more active upstream community. - - -== NSS uses SQL as default file format - -In Fedora 28, the default file format used by the *NSS* library is changed to SQL. - -The Network Security Services (NSS) library, which is used by Mozilla Firefox, Gnome Evolution, Mozilla Thunderbird, and other applications, changed its default database format for storing keys, certificates, and trust information. The new database format is based on SQlite and uses the filenames `cert9.db`, `key4.db`, and `pkcs11.txt`. The previous database format used Berkeyley DB (DBM) and filenames `cert8.db`, `key3.db`, and `secmod.db`. - -The primary benefit of the SQlite storage is support for concurrent access by multiple applications. When using the previous default file format based on DBM, accidental concurrent access could result in corrupted storage. - -Unless an application explicitly requests either the DBM or SQL format, the NSS library will automatically migrate the application's NSS database from the old to the new format. The old database files will not be updated further. Most users should not experience differences in operation. Applications that perform many NSS read/write operations may experience a minor performance decrease. Use the following command to trigger an explicit migration: - ----- -certutil -d sql: -N -f \ - -@ ----- - -Users who store their system home or application data directory on a network filesystem are advised to set the `NSS_SDB_USE_CACHE=yes` environment variable prior to starting applications that use NSS. Without setting this environment variable, users of network filesystems may experience a major slowdown with some applications, such as Firefox. The environment variable enables the use of a caching strategy in NSS that works around the slowness of network filesystems. Because this caching strategy causes a performance decrease on fast filesystems. - -Additional technical details can be found in the Fedora Wiki: link:https://fedoraproject.org/wiki/Changes/NSSDefaultFileFormatSql[]. - - -== Deprecate TCP wrappers - -Fedora 28 https://fedoraproject.org/wiki/Changes/Deprecate_TCP_wrappers[removes support] for `tcp_wrappers` (aka `/etc/hosts.deny` access files) by default from all the network daemons and tools. -The preferred replacements are software firewalld, nftables rules or software specific access rules for more complex filtering. -If your system security depends on `tcp_wrappers` rules, convert them to firewall rules, or set up `tcpd` to do the same job for you. - -== OpenLDAP switches from NSS to OpenSSL - -With this update, the OpenLDAP distribution in Fedora changed from using the *NSS* (or *MozNSS*) library to the *OpenSSL* library for providing cryptographic functions. The switch promises better support from OpenLDAP upstream, which had ceased maintaining the NSS support layer. - - -== OpenLDAP defaults to use only Shared System Certificates - -OpenLDAP clients and server now use the https://fedoraproject.org/wiki/Features/SharedSystemCertificates[system-wide certificate store] by default, instead of `/etc/openldap/certs`. - - -== OpenLDAP drops TCP wrappers support - -Fedora has https://fedoraproject.org/wiki/Changes/Deprecate_TCP_wrappers[deprecated the use of TCP wrappers]. -The OpenLDAP project also https://www.openldap.org/doc/admin24/security.html#TCP%20Wrappers[discourages their use] and recommends that an IP firewall is used instead. -With this update, OpenLDAP will not be configured with `--enable-wrappers` and so any TCP wrappers configuration will have no effect on OpenLDAP. -Other means should be used to protect the OpenLDAP server. - - -== Replace authconfig with authselect - -Fedora 28 replaces authconfig with authselect as the default tool for generating PAM configuration files and nsswitch.conf. -On new installations, authselect, together with an authconfig compatibility tool, will be installed by default instead of authconfig. -On upgraded installations, authconfig will be replaced with authselect and the compatibility tool but the configuration generated by authconfig will be left intact. -The authconfig compatibility tool will be removed from Fedora in a future release. -The https://github.com/pbrezina/authselect/tree/master/src/man/authselect-migration.7.txt.in.in[authselect-migration(7)] man page explains how to migrate from authconfig to authselect. diff --git a/en-US/sysadmin/System_Utilities.adoc b/en-US/sysadmin/System_Utilities.adoc deleted file mode 100644 index 96bd303..0000000 --- a/en-US/sysadmin/System_Utilities.adoc +++ /dev/null @@ -1,15 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-utilities]] -= System Utilities - -[[sect-utilities-time]] -== GNU time 1.8 - -The time command runs another program, then displays information about the resources used by that program. -This version of time has changed the default output format. -If the measured command fails, time will report about it on the first line of standard error output. -This report can be suppressed by using the -q option. -The POSIX mode (-p option) is unchanged. -Users are advised to review their scripts for make sure they can parse the new time output. diff --git a/en-US/sysadmin/Virtualization.adoc b/en-US/sysadmin/Virtualization.adoc deleted file mode 100644 index 376c709..0000000 --- a/en-US/sysadmin/Virtualization.adoc +++ /dev/null @@ -1,18 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-virtualization]] -= Virtualization - -[[sect-virtualbox]] -== VirtualBox Guest Integration - -The _kernel_ package now includes the vboxguest driver for Virtual Box Guest integration. -The `virtualbox-guest-additions` package, which provides support for better integration of VirtualBox guests with the host, is also included. -Features include: - -* Automatic resizing of the guest desktop-resolution to the vm's window-size -* Seamless mode support (only show guest windows, hide guest background) -* Copy and paste between guest and host - -All of these features are enabled by default in Fedora Workstation. diff --git a/en-US/sysadmin/Xorg.adoc b/en-US/sysadmin/Xorg.adoc deleted file mode 100644 index 72887f8..0000000 --- a/en-US/sysadmin/Xorg.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-x-org]] -= X.Org diff --git a/en-US/welcome/Feedback.adoc b/en-US/welcome/Feedback.adoc deleted file mode 100644 index 5e8149d..0000000 --- a/en-US/welcome/Feedback.adoc +++ /dev/null @@ -1,21 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-Release_Notes-Feedback]] -= Feedback - -Thank you for taking the time to provide your comments, suggestions, and bug reports to the Fedora community; this helps improve the state of Fedora, Linux, and free software worldwide. - -== Providing Feedback on Fedora Software - -To provide feedback on Fedora software or other system elements, please refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common F26 Bugs] on the wiki. - -== Providing Feedback on Release Notes - -If you feel these release notes could be improved in any way, you can provide your feedback directly to the beat writers. There are several ways to provide feedback, in order of preference: - -* If you have a Fedora account, edit content directly at link:++http://fedoraproject.org/wiki/Docs/Beats++[Docs-Beats] page on the wiki. - -* Fill out a bug request using link:{BZURL}[http://pagure.io/] - *This link is ONLY for feedback on the release notes themselves.* Refer to the admonition above for details. - -* E-mail the Release-Note mailing list at link:mailto:relnotes@fedoraproject.org[relnotes@fedoraproject.org]. diff --git a/en-US/welcome/Hardware_Overview.adoc b/en-US/welcome/Hardware_Overview.adoc deleted file mode 100644 index f4156da..0000000 --- a/en-US/welcome/Hardware_Overview.adoc +++ /dev/null @@ -1,79 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-hardware-overview]] -= Hardware Overview - -Fedora {PRODVER} provides software to suit a wide variety of applications. The storage, memory and processing requirements vary depending on usage. For example, a high traffic database server requires much more memory and storage than a business desktop, which in turn has higher requirements than a single-purpose virtual machine. - -[[hardware_overview-specs]] -== Minimum System Configuration - -The figures below are a recommended minimum for the default installation. Your requirements may differ, and most applications will benefit from more than the minimum resources. - -* 1GHz or faster processor - -* 1GB System Memory - -* 10GB unallocated drive space - -.Low memory installations -[NOTE] -==== -Fedora {PRODVER} can be installed and used on systems with limited resources for some applications. Text, VNC, or kickstart installations are advised over graphical installation for systems with very low memory. Larger package sets require more memory during installation, so users with less than 768MB of system memory may have better results preforming a minimal install and adding to it afterward. - -For best results on systems with less than 1GB of memory, use the DVD installation image. -==== - -[[hardware_overview-resolution]] -== Display resolution - -.Graphical Installation requires 800x600 resolution or higher -[NOTE] -==== -Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation. - -Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation. -==== - -[[hardware_overview-graphics]] -== Graphics Hardware - -[[hardware_overview-graphics-legacy_gpus]] -=== Minimum Hardware for Accelerated Desktops - -Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration: - -* Intel prior to GMA9xx - -* NVIDIA prior to NV30 (GeForce FX5xxx series) - -* Radeon prior to R300 (Radeon 9500) - -[[hardware_overview-graphics-cpu_acceleration]] -=== CPU Accelerated Graphics - -Systems with older or no graphics acceleration devices can have accelerated desktop environments using *LLVMpipe* technology, which uses the CPU to render graphics. *LLVMpipe* requires a processor with `SSE2` extensions. The extensions supported by your processor are listed in the `flags:` section of `/proc/cpuinfo` - -[[hardware_overview-graphics-desktops]] -=== Choosing a Desktop Environment for your hardware - -Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. - -Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command: - ----- -# dnf grouplist -v hidden | grep desktop ----- - -Install the desired group: - ----- -# dnf groupinstall "KDE Plasma Workspaces" ----- - -Or, use the short group name to install: - ----- -# dnf install @mate-desktop-environment ----- diff --git a/en-US/welcome/Overview.adoc b/en-US/welcome/Overview.adoc deleted file mode 100644 index 56c0068..0000000 --- a/en-US/welcome/Overview.adoc +++ /dev/null @@ -1,9 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-overview]] -= Overview - -As always, Fedora continues to develop and integrate the latest free and open source software. The following sections provide a brief overview of major changes from the last release of Fedora. - -More detailed information about changes in this release can be found on the link:https://fedoraproject.org/wiki/Releases/{PRODVER}/ChangeSet[Fedora Project Wiki]. diff --git a/en-US/welcome/Welcome.adoc b/en-US/welcome/Welcome.adoc deleted file mode 100644 index 1e2ac6b..0000000 --- a/en-US/welcome/Welcome.adoc +++ /dev/null @@ -1,39 +0,0 @@ - -include::en-US/entities.adoc[] - -[[sect-welcome_to_fedora]] -= Welcome to Fedora - -The Fedora Project is a partnership of Free software community members from around the globe. The Fedora Project builds open source software communities and produces a Linux distribution called Fedora. - -The Fedora Project's mission is to lead the advancement of Free and open source software and content as a collaborative community. The three elements of this mission are clear: - -* The Fedora Project always strives to lead, not follow. - -* The Fedora Project consistently seeks to create, improve, and spread Free/Libre code and content. - -* The Fedora Project succeeds through shared action on the part of many people throughout our community. - -To find out more general information about Fedora, refer to the following pages, on the Fedora Project Wiki: - -* link:++http://fedoraproject.org/wiki/Overview++[Fedora Overview] - -* link:++http://fedoraproject.org/wiki/FAQ++[Fedora FAQ] - -* link:++http://fedoraproject.org/wiki/Communicate++[Help and Discussions] - -* link:++http://fedoraproject.org/wiki/Join++[Participate in the Fedora Project] - -[[sect-need-help]] -== Need Help? - -There are a number of places you can get assistance should you run into problems. - -If you run into a problem and would like some assistance, go to link:++http://ask.fedoraproject.org++[]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too. - -You may also find assistance on the `#fedora` channel on the IRC net `irc.freenode.net`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available. - -[[sect-providing-help]] -== Want to Contribute? - -You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation. diff --git a/index-main.html b/index-main.html deleted file mode 100644 index 28c1b66..0000000 --- a/index-main.html +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - - - - Fedora Documentation Website - - - - - - - - - - - -
-
-
- -
-
-
-
-

Fedora Documentation Site

-

Test Build.

-
-
-
Fedora Documentation
-
- -  Fedora 28 Documentation - - -  Rawhide Documentation - -
-
-
-
-
-
-
-
-
-

About

-
-
-
About Fedora
-
Sponsors
-
Fedora Magazine
-
Legal
-
-
    -
  • - -
    • -
  • - -
    • -
  • - -
    • -
-
-
- -
-

Download

-
-
-
Get Fedora Workstation
-
Get Fedora Server
-
Get Fedora Atomic
-
Fedora Spins
-
Fedora Labs
-
Fedora ARM®
-
Alternative Downloads
- -
-
-
- -
-

Support

-
-
-
Get Help
-
Ask Fedora
-
Common Bugs
-
Fedora Developer Portal
-
Release Notes
-
-
-
- -
-

Join

-
-
-
Join Fedora
-
Planet Fedora
-
Fedora SIGs
-
Fedora Account System
-
Fedora Community
-
-
-
-
- -
-
-
- -
-
-
-
- - -

© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the websites team

-
-
-
- -
-
-
- - - - - - diff --git a/modules/release-notes/assets/images/title_logo.svg b/modules/release-notes/assets/images/title_logo.svg new file mode 100644 index 0000000..e8fd52b --- /dev/null +++ b/modules/release-notes/assets/images/title_logo.svg @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc new file mode 100644 index 0000000..3a6baa3 --- /dev/null +++ b/modules/release-notes/nav.adoc @@ -0,0 +1,34 @@ +* xref:index.adoc[Book Information] +* Welcome to Fedora +** xref:welcome/Welcome.adoc[Welcome to Fedora] +** xref:welcome/Overview.adoc[Overview] +** xref:welcome/Hardware_Overview.adoc[Hardware Overview] +** xref:welcome/Feedback.adoc[Feedback] +* Changes in Fedora for System Administrators +** xref:sysadmin/Modularity.adoc[Fedora Add-On Modularity] +** xref:sysadmin/Kernel.adoc[Kernel] +** xref:sysadmin/Installation.adoc[Installation] +** xref:sysadmin/Security.adoc[Security] +** xref:sysadmin/Automation.adoc[Automation] +** xref:sysadmin/Virtualization.adoc[Virtualization] +** xref:sysadmin/Mail_Servers.adoc[Mail Servers] +** xref:sysadmin/Xorg.adoc[X.Org] +** xref:sysadmin/System_Utilties.adoc[System Utilties] +* Changes in Fedora for Desktop Users +** xref:desktop/Desktop.adoc[Desktop] +** xref:desktop/Networking.adoc[Networking] +** xref:desktop/I18n.adoc[Internationalization] +* Changes in Fedora for Developers +** xref:developers/Development_Tools.adoc[Development Tools] +** xref:developers/Development_C.adoc[C] +** xref:developers/Containers.adoc[Containers] +** xref:developers/Development_Boost.adoc[Boost] +** xref:developers/Development_D.adoc[D] +** xref:developers/Development_Erlang.adoc[Erlang] +** xref:developers/Development_Go.adoc[Go] +** xref:developers/Development_Haskell.adoc[Haskell] +** xref:developers/Development_Python.adoc[Python] +** xref:developers/Development_Ruby.adoc[Ruby] +** xref:developers/Development_Rust.adoc[Rust] +** xref:developers/Development_Web.adoc[Web Development] +* xref:Revision_History.adoc[Revision History] diff --git a/modules/release-notes/pages/Revision_History.adoc b/modules/release-notes/pages/Revision_History.adoc new file mode 100644 index 0000000..0e6a66b --- /dev/null +++ b/modules/release-notes/pages/Revision_History.adoc @@ -0,0 +1,10 @@ + +include::{partialsdir}/entities.adoc[] + +[[appe-Release_Notes-Revision_History]] += Revision History + +`26.01-3`:: Sun Jul 30 2017, (docs AT lists.fedoraproject.org), First AsciiDoc version. + +`26.01-2`:: Tue Jul 11 2017, (docs AT lists.fedoraproject.org) + diff --git a/modules/release-notes/pages/_partials/Author_Group.adoc b/modules/release-notes/pages/_partials/Author_Group.adoc new file mode 100644 index 0000000..b7ff345 --- /dev/null +++ b/modules/release-notes/pages/_partials/Author_Group.adoc @@ -0,0 +1 @@ +.The Fedora Docs Team diff --git a/modules/release-notes/pages/_partials/Feedback.adoc b/modules/release-notes/pages/_partials/Feedback.adoc new file mode 100644 index 0000000..f438831 --- /dev/null +++ b/modules/release-notes/pages/_partials/Feedback.adoc @@ -0,0 +1,26 @@ + +:experimental: + +== We want feedback +indexterm:[feedback,contact information for this manual] +If you find errors or have suggestions for improvement, we want your advice. Submit a report in Bugzilla against the product `{PRODUCT}` and the component `{BOOKID}`. The following link automatically loads this information for you: {BZURL}. + +In Bugzilla: + +. Provide a short summary of the error or your suggestion in the `Summary` field. + +. Copy the following template into the `Description` field and give us the details of the error or suggestion as specifically as you can. If possible, include some surrounding text so we know where the error occurs or the suggestion fits. ++ +[subs="quotes"] +---- +Document URL: + +Section number and name: + +Error or suggestion: + +Additional information: + +---- + +. Click the btn:[Submit Bug] button. diff --git a/modules/release-notes/pages/_partials/Legal_Notice.adoc b/modules/release-notes/pages/_partials/Legal_Notice.adoc new file mode 100644 index 0000000..b65d4a5 --- /dev/null +++ b/modules/release-notes/pages/_partials/Legal_Notice.adoc @@ -0,0 +1,22 @@ + +:experimental: + +Copyright {YEAR} {HOLDER}. + +The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at link:++http://creativecommons.org/licenses/by-sa/3.0/++[]. The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. + +Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. + +Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. + +For guidelines on the permitted uses of the Fedora trademarks, refer to link:++https://fedoraproject.org/wiki/Legal:Trademark_guidelines++[]. + +*Linux* (R) is the registered trademark of Linus Torvalds in the United States and other countries. + +*Java* (R) is a registered trademark of Oracle and/or its affiliates. + +*XFS* (R) is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. + +*MySQL* (R) is a registered trademark of MySQL AB in the United States, the European Union and other countries. + +All other trademarks are the property of their respective owners. diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc new file mode 100644 index 0000000..3e067dd --- /dev/null +++ b/modules/release-notes/pages/_partials/entities.adoc @@ -0,0 +1,10 @@ +:BOOKID: release-notes +:BZURL: https://pagure.io/release-notes +:COMMONBUGS_URL: http://fedoraproject.org/wiki/Common_F28_bugs +:HOLDER: Fedora Project Contributors +:KERNEL: 4.8 +:NEXTVER: Rawhide +:PREVVER: 27 +:PRODUCT: Fedora Documentation +:PRODVER: 28 +:YEAR: 2018 diff --git a/modules/release-notes/pages/desktop/Desktop.adoc b/modules/release-notes/pages/desktop/Desktop.adoc new file mode 100644 index 0000000..80f2082 --- /dev/null +++ b/modules/release-notes/pages/desktop/Desktop.adoc @@ -0,0 +1,22 @@ +include::{partialsdir}/entities.adoc[] + +[[sect-desktop]] += Desktop + +[[sect-desktop-librealsense]] +== librealsense2 + +A new version of librealsense has been released to support new models of RealSense cameras. +The librealsense library will be upgraded to the new release. The previous version of the library will be changed to librealsense1 to support older model RealSense cameras. + +New Cameras supported by the updated version of librealsense library include: D400, D410, D415, D420, D430, D435, D4m. + +Older Cameras that can be supported by the previous library now named librealsense1: R200, F200, SR300, LR200, ZR300 +For more information about librealsense please visit their github page: link++:https://github.com/IntelRealSense/librealsense/++[https://github.com/IntelRealSense/librealsense] + +[[sect-desktop-sugar]] +== Sugar 0.112 + +Sugar is a free and open-source desktop environment designed for interactive learning by children. +In Fedora 28, Sugar has been updated to version 0.112. +Information about the new features in Sugar is available in the https://wiki.sugarlabs.org/go/0.112[Sugar 0.112 release notes]. diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc new file mode 100644 index 0000000..d77b807 --- /dev/null +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -0,0 +1,31 @@ +include::{partialsdir}/entities.adoc[] + +:experimental: + +[[sect-i18n]] += Internationalization + +[[sect-i18n-ibus]] +== IBus 1.5.18 + +* IBus core package has provided an emoji dialog which can be launched with kbd:[Ctrl+Shift+E] shortcut key footnote:[The shortcut key can be customized with `ibus-setup` utility] and the emoji dialog now accepts Unicode names besides emoji annotations. _E.g. "`a with grave`" shows *À* (I.E. U+00C0)._ footnote:[To insert the space, kbd:[Shift+Space] key is avaiable.] +* When you open "`Open Unicode choice`" on the emoji category list of the emoji dialog, The Unicode name list is open. +* In the previous releases, the shortcut key kbd:[Ctrl+Shift+E] was not available in GNOME desktop environment but the shortcut key is now available in any desktop environmets. However to enable the shortcut key in GNOME, you have to add one more IBus input method sources besides XKB sources with `gnome-control-center region` utility. _E.g. If you have "`English (US)`" and "`French`", you also need to add "`English (English – US (Typing Booster))`" or "`Other (rawcode)`" or "`Chinese (Intelligent Pinyin)`" or else so that you apply IBus engines to "`English (US)`" and "`French`" XKB sources._ +* kbd:[PageUp], kbd:[PageDown], kbd:[Ctrl+Shift+N], kbd:[Ctrl+Shift+P] keys are now available to shift pages on the Unicode name list. + +To get furthermore infomation, refer https://desktopi18n.wordpress.com/2018/03/06/ibus-1-5-18-is-released/ + +[[sect-i18n-fontconfig]] +== fontconfig 2.13 + +The fontconfig package is updated to the version 2.13 which contains the following features and bug fixes: + + * config file description support + * allow sharing caches under the bind-mounted dirs + * improve footprint on creating caches + * variable fonts support + +[[sect-i18n-glibc]] +== Glibc collation update and sync with CLDR + +The collation data in glibc is extremely out of date, most locales base their collation rules on an iso14651_t1_common file which has not been updated for probably more than 15 years. Therefore, all characters added in later Unicode versions are missing and not sorted at all which causes bugs like [Bug 1336308 - Infinite (∞) and empty set (∅) are treated as if they were the same character by sort and uniq]. This change is about updating that iso146541_t1_common file to the latest available version from ISO which is from 2016 and up-to-date with Unicode 9.0.0. Because additions and changes in the syntax of the new iso146541_t1_common file, updating that file requires changing the collation rules of almost all locales. Because all these collation rules have to be touched anyway, this is a good opportunity to fix bugs in the collation ruies and sync them with the collation rules in CLDR. diff --git a/modules/release-notes/pages/desktop/Networking.adoc b/modules/release-notes/pages/desktop/Networking.adoc new file mode 100644 index 0000000..98689b1 --- /dev/null +++ b/modules/release-notes/pages/desktop/Networking.adoc @@ -0,0 +1,5 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-networking]] += Networking diff --git a/modules/release-notes/pages/developers/Containers.adoc b/modules/release-notes/pages/developers/Containers.adoc new file mode 100644 index 0000000..d807f06 --- /dev/null +++ b/modules/release-notes/pages/developers/Containers.adoc @@ -0,0 +1,5 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-containers]] += Containers diff --git a/modules/release-notes/pages/developers/Development_Boost.adoc b/modules/release-notes/pages/developers/Development_Boost.adoc new file mode 100644 index 0000000..d4a3be3 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Boost.adoc @@ -0,0 +1,16 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-boost]] += Boost + +== Fedora 28 Boost 1.66 upgrade +*Boost* has been upgraded to version 1.66. Apart from a number of bugfixes and improvements to existing libraries, this brings several new libraries compared to Fedora 27: `Boost.PolyCollection`, `Boost.Stacktrace`, `Boost.Beast`, `Boost.CallableTraits`, `Boost.Mp11`. + +One library has been removed, `Boost.TR1`, and a number of deprecated APIs in `Boost.Asio` have been removed. Code using `Boost.TR1` should be modified to use the equivalent features provided by other Boost libraries (e.g. `Boost.Tuple`, `Boost.Unordered`) or in the C++ standard library (e.g. `std::tuple`, `std::unordered_map`). Code using the deprecated Asio APIs should be modified by removing the `io_service` arguments. + +You can find full lists of changes compared to Fedora 27 in upstream release notes: + +* link:++http://www.boost.org/users/history/version_1_66_0.html++[1.66 release notes] +* link:++http://www.boost.org/users/history/version_1_65_1.html++[1.65.1 release notes] +* link:++http://www.boost.org/users/history/version_1_65_0.html++[1.65 release notes] diff --git a/modules/release-notes/pages/developers/Development_C.adoc b/modules/release-notes/pages/developers/Development_C.adoc new file mode 100644 index 0000000..73d7227 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_C.adoc @@ -0,0 +1,38 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-c]] += C + +[[sect-c-sunrpc]] +== Sun RPC Interfaces Moved From glibc To libtirpc + +Fedora 28 now uses https://sourceforge.net/projects/libtirpc/[libtirpc] to implement the Sun RPC protocol. + +The glibc imlementation of Sun RPC was not compatible with IPv6 and adding IPv6 support would have required a change to the glibc ABI. +As a result, the Sun RPC implementation was moved to a separate library, libtirpc, which has been packaged in Fedora since Fedora 7. +Sun RPC support in glibc has been deprecated for a long time and this change aligns Fedora with the upstream projects. + + +== Libcrypt replaced by libxcrypt in glibc + +In reaction to plans to remove the *libcrypt* library from *glibc*, this update replaces *libcrypt* in Fedora's version of *glibc* with the *libxcrypt* library. The use of the *libxcrypt* library allows easier integration of new hashing algorithms, promises the benefits of a faster development cycle than *libcrypt*, and provides support for all hashing algorithms ever introduced to the `crypt()` function. + + +[discrete] +=== Compatibility + +The *libxcrypt* library is backwards binary compatible with `libcrypt.so.1` shipped as a part of the GNU{nbsp}C Library. Therefore, all binaries built against *libcrypt* should work without modifications with `libcrypt.so.1` provided by *libxcrypt*. It is, however, not possible to recompile programs that use the following legacy APIs supplied by *libcrypt* against *libxcrypt*: `encrypt`, `encrypt_r`, `setkey`, `setkey_r`, and `fcrypt`. + +There is, also, no reverse compatibility. Therefore, binaries linked against `libcrypt.so.1` provided by *libxcrypt* will not work with *glibc*'s default *libcrypt*. + +To list all packages built against *libcrypt*, run the following command: + +---- +sudo dnf repoquery --whatrequires 'libcrypt.so*' | sed -e 's!-[0-9]\+.*$!!g' | sort -u +---- + +== The GNU C Library version 2.27 +Fedora 28 provides the GNU C Library (*glibc*) version 2.27. + +See the link:++https://sourceware.org/ml/libc-announce/2018/msg00000.html++[release announcement] for full information about changes brought by this version, and the link:++https://sourceware.org/glibc/wiki/Release/2.27#Packaging_Changes++[glibc wiki entry about this release] which contains a section on packaging changes. Also note the separate change related to *glibc* described in <>. diff --git a/modules/release-notes/pages/developers/Development_D.adoc b/modules/release-notes/pages/developers/Development_D.adoc new file mode 100644 index 0000000..141744c --- /dev/null +++ b/modules/release-notes/pages/developers/Development_D.adoc @@ -0,0 +1,5 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-d]] += D diff --git a/modules/release-notes/pages/developers/Development_Erlang.adoc b/modules/release-notes/pages/developers/Development_Erlang.adoc new file mode 100644 index 0000000..2be5a73 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Erlang.adoc @@ -0,0 +1,27 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-erlang]] += Erlang + +[[sect-erlang-erlang20]] +== Erlang 20 + +Erlang/OTP has been updated to version 20. +Highlights from the changes introduced in v20 include: + +- so-called 'dirty schedulers' are available on systems with SMP; +- atoms may now contain arbitrary Unicode characters (for example, 'здравствуй-你好'); +- Erlang applications can now handle some OS signals (SIGHUP, for example); +- improved unicode support for strings; +- the zlib module has been refactored and all its operations will now yield appropriately, allowing them to be used freely in concurrent applications. + +Fedora's Erlang package maintainers have also improved the integration of Erlang with the rest of the system. +Erlang developers can now benefit from: + +- improved logging to journald; +- access to D-Bus from the erlang-dbus package; +- improved Erlang Packaging Guidelines. + +More information about the changes in Erlang is available from the https://www.erlang.org/news[Erlang website]. +More information about the improved integration into Fedora is available from the Fedora https://fedoraproject.org/wiki/Changes/Erlang_20[change description]. diff --git a/modules/release-notes/pages/developers/Development_Go.adoc b/modules/release-notes/pages/developers/Development_Go.adoc new file mode 100644 index 0000000..dc26c80 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Go.adoc @@ -0,0 +1,10 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-development-go]] += Go + + +== Golang rebased to 1.10 + +With this update, Golang packages have been rebased to version 1.10. The new version offers performance improvements, support for new instructions, new features, and bugfixes. See link:https://tip.golang.org/doc/go1.10[] for a detailed list of all changes in version 1.10. All dependent packages have been rebuilt. diff --git a/modules/release-notes/pages/developers/Development_Haskell.adoc b/modules/release-notes/pages/developers/Development_Haskell.adoc new file mode 100644 index 0000000..127f1fd --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Haskell.adoc @@ -0,0 +1,15 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-haskell]] += Haskell + +== GHC 8.2 +Fedora 28 brings version 8.2.2 of the *GHC* Haskell compiler. + +For full information about new features and bug fixes in this update, see the upstream release notes at: + +* link:++https://downloads.haskell.org/~ghc/8.2.2/docs/html/users_guide/8.2.1-notes.html++[8.2.1 Release Notes] +* link:++https://downloads.haskell.org/~ghc/8.2.2/docs/html/users_guide/8.2.2-notes.html++[8.2.2 Release Notes] + +If you want to migrate your applications from GHC 8.0 to this version, see the link:++https://ghc.haskell.org/trac/ghc/wiki/Migration/8.2++[upstream migration guide]. diff --git a/modules/release-notes/pages/developers/Development_Python.adoc b/modules/release-notes/pages/developers/Development_Python.adoc new file mode 100644 index 0000000..1709912 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Python.adoc @@ -0,0 +1,26 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-python]] += Python + +[[sect-python-kerberos]] +== Kerberos in Python Modernization + +There is https://fedoraproject.org/wiki/Changes/kerberos-in-python-modernization[an ongoing project] to replace `python-krbV` and `pykerberos` with `python-gssapi` in all Fedora packages. +`python-gssapi` uses the GSSAPI interface, which is widely standardized, implemented by both MIT and Heimdal Kerberos, and much more user-friendly. + +None of the packages has been removed in Fedora 28 but the following packages should be considered as deprecated: + +* python{2,}-kerberos +* python2-krbV +* python-urllib2_kerberos +* python{2,}-requests-kerberos + +[[sect-python-generators]] +== Python Module Dependency Generation + +Fedora 28 introduces the ability to use an automated Python module dependency generator for packages that provide Python Egg/Wheel metadata. +Automatic generation of Provides has been enabled in Fedora since Jun 2016. +As a result, all packages that include egg/wheel metadata now have their Provides entries added automatically. +With this release, packagers are able to take advantage of automatic generation of Requires entries, removing the need to specify runtime dependencies manually. diff --git a/modules/release-notes/pages/developers/Development_Ruby.adoc b/modules/release-notes/pages/developers/Development_Ruby.adoc new file mode 100644 index 0000000..eb9e5e1 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Ruby.adoc @@ -0,0 +1,24 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-ruby]] += Ruby + +== Ruby 2.5 +Ruby 2.5 is the latest stable version of Ruby. Many new features and improvements are included for the increasingly diverse and expanding demands for Ruby. With this major update from Ruby 2.4 in Fedora 26 to Ruby 2.5 in Fedora 28, Fedora becomes the superior Ruby development platform. + +New features: + +* `rescue`/`else`/`ensure` are now allowed to be used directly with `do`/`end` blocks. +* Add `yield_self` to yield given block in its context. Unlike `tap`, it returns the result of the block. +* Support branch coverage and method coverage measurement. The branch coverage indicates which branches are executed and which are not. The method coverage indicates which methods are invoked and which are not. By running a test suite with these new features, you will know which branches and methods are executed, and evaluate total coverage of the test suite more strictly. +* `Hash#slice` and `Hash#transform_keys`. +* `Struct.new` can create classes that accept keyword arguments. +* Enumerable `#any?`, `all?`, `none?`, and `one?` accept a pattern argument. +* Top-level constant look-up is no longer available. +* One of our most loved libraries, `pp.rb`, is now automatically loaded. You no longer have to write require `pp`. +* Print backtrace and error message in reverse order (oldest call first, most recent call last). When a long backtrace appears on your terminal (TTY), you can easily find the cause line at the bottom of the backtrace. Note that the order is reversed only when the backtrace is printed out to the terminal directly. + +The source level compatibility with previous versions of Ruby should be preserved. Nevertheless, user specific Ruby binary extensions need to be rebuild. + +See the link:++https://github.com/ruby/ruby/blob/v2_5_0/NEWS++[upstream release notes] for more information about Ruby 2.5. diff --git a/modules/release-notes/pages/developers/Development_Rust.adoc b/modules/release-notes/pages/developers/Development_Rust.adoc new file mode 100644 index 0000000..5c1e544 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Rust.adoc @@ -0,0 +1,12 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-rust]] += Rust + +[[sect-rust-packaging]] +== Packaging Rust Applications and Libraries + +Fedora is one of the first distributions to package software written in the Rust programming language. +Fedora 28 includes the tools and instructions necessary to package applications and libraries written in Rust. +As a result, users will be able to install software developed in Rust (for example, *ripgrep*) from the Fedora repositories. diff --git a/modules/release-notes/pages/developers/Development_Tools.adoc b/modules/release-notes/pages/developers/Development_Tools.adoc new file mode 100644 index 0000000..e0231a5 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Tools.adoc @@ -0,0 +1,43 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-development-tools]] += Development Tools + + +== GCC 8.1 + +Fedora 28 comes with *GCC 8.1* as the primary compiler. See link:http://gcc.gnu.org/gcc-8/changes.html[] for user-visible changes in the new version. + + +== Binutils rebased to 2.29.1 + +The *binutils* collection of tools has been rebased from version 2.29 to 2.29.1. This minor release does not introduce any new features, but it includes a number of important bug fixes. In addition, the default build flags have been changed to include `-z defs`, so that undefined symbols result in errors. The benefit is that this prevents shipping dynamic shared objects (DSO) that are not correctly linked because they refer to versioned symbols as plain undefined symbols without specifying a symbol version. + +[[sect-development-tools-]] +== Hardening Flags Updates + +Fedora 28 has been built with updated hardening flags, as provided by the GNU toolchain. +Compared to previous releases, the following changes have been made to the way programs are built: + +* Stack clash protection is enabled. +* Lightweight assertions have been switched on in the C++ standard run-time library. +* On x86-64, binaries have been built in such a way that they will support Control Flow Enforcement Technology (CET) in the future. +* On systems which support memory protection keys, lazy binding now uses a read-only GOT. +* By default the toolchain generates PIE executables to further harden Fedora executables from attacks. + +[[sect-ldconfig-scriptlets]] +== Removing ldconfig Scriptlets + +Packages in Fedora repositories included calls to ldconfig in `%post` and `%postun` sections of the spec file if they package shared libraries. +With Fedora 28, packages can use _file triggers_, which allow faster installation of packages as `ldconfig` is run only once per transaction. + +NOTE: If your package places shared libraries in special locations referenced by `ld.so.conf`, you still need to run `ldconfig` manually. + +More information about this change can be found on related https://fedoraproject.org/wiki/Changes/Removing_ldconfig_scriptlets[Fedora change page]. +[[sect-mingw-debuginfo]] + +== DebugInfo Included by Default in MinGW Binaries + +MinGW binaries contain symbol names by default to allow for easier debugging of Windows applications cross-compiled from Fedora. +Full debug information is still available in the `debuginfo` packages. diff --git a/modules/release-notes/pages/developers/Development_Web.adoc b/modules/release-notes/pages/developers/Development_Web.adoc new file mode 100644 index 0000000..9e4ad9b --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Web.adoc @@ -0,0 +1,21 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-web-development]] += Web Development + +== PHP 7.2 +Fedora 28 provides PHP 7.2. + +As the list of changes is too extensive to cover in this document, and at the same time all changes are documented upstream, you are encouraged to read the link:++http://www.php.net/ChangeLog-7.php#7.2.0++[upstream changelog] and link:++https://raw.githubusercontent.com/php/php-src/PHP-7.2/UPGRADING++[upgrade notes]. A link:++http://php.net/manual/en/migration72.php++[migration guide] is also available to anyone wishing to migrate from version 7.1. + +== Django 2.0 +Fedora 28 provides versin 2.0 of the *Django* framework. Notable changes include: + +* Simplified routing syntax +* Mobile-friendly administration interfaces +* Brand new Windows expressions + +*Django 2.0* only supports *Python 3*, support for *Python 2* has been dropped. If you previously used _python2-django_ from a RPM package, make sure you use _python3-django_ and run your code on *Python 3*. A backward compatible package, _python2-django1.11_, is also provided for cases where migration to Python 3 is not possible. + +See the link:++https://docs.djangoproject.com/en/2.0/releases/2.0/++[upstream release notes] for a full list of changes in this release. diff --git a/modules/release-notes/pages/index.adoc b/modules/release-notes/pages/index.adoc new file mode 100644 index 0000000..841880e --- /dev/null +++ b/modules/release-notes/pages/index.adoc @@ -0,0 +1,16 @@ + +include::{partialsdir}/entities.adoc[] + += Release Notes + +Release Notes for Fedora {PRODVER} + +[abstract] +-- +This document provides the release notes for Fedora {PRODVER}. It describes major changes offered as compared to Fedora {PREVVER}. +-- + +image:title_logo.svg[Fedora Logo] +include::{partialsdir}/Legal_Notice.adoc[] + +include::{partialsdir}/Author_Group.adoc[] diff --git a/modules/release-notes/pages/sysadmin/Automation.adoc b/modules/release-notes/pages/sysadmin/Automation.adoc new file mode 100644 index 0000000..79897bf --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Automation.adoc @@ -0,0 +1,14 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-automation]] += Automation + +[[sect-automation-facter]] +== Facter 3 + +Facter is *Puppet’s* cross-platform system profiling library. +Fedora 28 updates the `facter` package from v2.x to v3.x. +The `ruby-facter` package must also be installed for any *Ruby* application or script to make use of the facter library. + +More information about the scope of the change is in the upstream https://docs.puppet.com/facter/3.0/release_notes.html[Facter 3 release notes]. diff --git a/modules/release-notes/pages/sysadmin/Installation.adoc b/modules/release-notes/pages/sysadmin/Installation.adoc new file mode 100644 index 0000000..2ac6489 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Installation.adoc @@ -0,0 +1,41 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-installation]] += Installation +This section describes changes in the *Anaconda* installer. + +== Anaconda modularization effort +*Anaconda* is going through a large scale effort to modularize its internals. (Note that this effort is separate from the _Fedora_ modularization effort described in <>.) The following changes have been made to *Anaconda*: + +* Modules have been added which are separate *Python* processes. They are connected to the main *Anaconda* process using *DBus*. +* Most Kickstart commands are now processed on separate modules, and used in the UI in many places as backend data sources. + +The modularization effort has no visible impact on the user experience. To read more about the installer internals, see the link:++https://rhinstaller.wordpress.com/++[installer team's blog]. + +== Kickstart changes +* The `authconfig` command has been deprecated by `authselect`. + +== Changes in boot options +New boot options: + +* `inst.stage2.all` - With this boot option, the stage 2 image will be fetched from HTTP, HTTPS and FTP locations which are specified using the `inst.stage2=` option sequentially in the order they are specified, until the image is successfully fetched. All other locations will be ignored. +* `inst.ks.all` - With this boot option, the Kickstart file will be fetched from HTTP, HTTPS and FTP locations which are specified using the `inst.ks=` option sequentially in the order they are specified, until the file is successfully fetched. All other locations will be ignored. +* `inst.xtimeout=` - Specifies a timeout period (in seconds) the installer will wait before starting the *X* server. + +== Reduced initial setup redundancy +When you install the _Workstation_ variant of Fedora 28 using the live image, you will now be prompted to create a user account by *GNOME Initial Setup* instead of Anaconda. Additionally, you will no longer be prompted to set a root password during the installation of Fedora Workstation using the live image. The `root` account will be disabled by default; you can enable it by setting a password for it using the `sudo passwd` command. If you do not reenable the `root` account, you can still perform any administrative tasks using `sudo` and your user password. + +These changes have been made in order to reduce redundancy between **Anaconda**, **Initial Setup**, and **GNOME Initial Setup**, which could previously all ask you to perform the same setup tasks. + +== Miscellaneous changes + +* Former dependencies of the _anaconda_ package itself have been separated into the _anaconda-install-env-deps_ package. +* The number of dependencies for *Initial Setup* has been massively decreased, which enables it to run on systems with a significantly lower amount of memory than before. +* Anaconda now enables hibernation by default on AMD and Intel (x86) systems. +* The progress bar displayed while the installation is in progress is now more accurate. +* The `pykickstart` and `blivet` libraries, which are used to handle Kickstart processing and storage configuration respectively, have been both upgraded to version `3`. +* Payload is usable usable in `InstallClass` +* You can now add sources in `InstallClass` +* `InstallClass` is now selected at runtime based on the `.buildstamp` file. +* `InstallClass` can now specify a Fedora variant which it should run on. This is defined by the `Variant` item in the `.buildstamp` file. diff --git a/modules/release-notes/pages/sysadmin/Kernel.adoc b/modules/release-notes/pages/sysadmin/Kernel.adoc new file mode 100644 index 0000000..bad4726 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Kernel.adoc @@ -0,0 +1,27 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-kernel]] += Kernel + +[[sect-kernel-battery]] +== Improved Laptop Battery Life + +Fedora 28 enables https://fedoraproject.org/wiki/Changes/ImprovedLaptopBatteryLife[a number of power saving features] by default for the first time. +The changes are in base packages and so all users will automatically gain these improvements upon upgrading. +As a result, laptops running Fedora will be able to last longer on battery power. + +== Thunderbolt enablement + +Fedora 28 adds support for Thunderbolt - an interface developed by Intel which allows connection of external peripherals to a computer. + +Devices connected via Thunderbolt are DMA masters, which means they can read system memory directly without interference from the computer's operating system or even CPU. To mitigate the security risk this type of access poses, there are four available security levels for communication, which are set by system firmware: + +* `none` - security is disabled, all devices are fully functional when connected +* `dponly` - only pass the DisplayPort stream through to the connected device +* `user` - connected devices must be manually authorized by the user +* `secure` - same as `user`, but also verify the device's identy through a secret key + +Starting with version 4.13, the Linux kernel provides an interface through `sysfs` which enables userspace query about the security level, the status of any connected devices, and to authorize devices if the security level demands it. The active security level must normally be selected before booting via a BIOS/EFI option, but it is interesting to note that the `none` option will likely be removed in the future. This would mean that connected Thunderbolt devices would not work unless authorized by the user from within the running operating system. + +For this reason, Fedora 28 implements full Thunderbolt 3 support. In order to avoid compromising the security, there are two userspace components working together to enable Thunderbolt: a system service (link:++https://src.fedoraproject.org/rpms/bolt++[`boltd`]) and a component in *GNOME Shell*. The shell component will automatically enroll (authorize and store in an internal database) any new connected devices using `boltd` only if the current user is an administrator and if the session is unlocked. After the device has been authorized once, its information is stored in the database and it will be authorized automatically on subsequent connections. diff --git a/modules/release-notes/pages/sysadmin/Mail_Servers.adoc b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc new file mode 100644 index 0000000..6c650eb --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc @@ -0,0 +1,5 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-mail-servers]] += Mail Servers diff --git a/modules/release-notes/pages/sysadmin/Modularity.adoc b/modules/release-notes/pages/sysadmin/Modularity.adoc new file mode 100644 index 0000000..dc75695 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Modularity.adoc @@ -0,0 +1,42 @@ + +include::{partialsdir}/entities.adoc[] + +[[select-modularity]] += Fedora Add-On Modularity + +link:++https://docs.pagure.org/modularity/++[Fedora Modularity] introduces an optional Modular repository that provides additional versions of software on independent lifecycles.  + +Users can now keep their operating system up-to-date while having the right version of an application for their use case, even when the default version in the distribution changes. + +[[select-modularity-features]] +== Features + +This change introduces three *new optional repositories for additional versions of software* delivered as module streams. + +Modules are collection of packages representing an application, a language stack, or a collection of package that make sense to be delivered together. An example could be a nodejs module. + +Streams are series of versions that are backwards compatible. An example could be two streams of nodejs — version 6.x and version 8.x compatible. + +*Client tooling (DNF) has been improved to be able to manage multiple streams of software*. Users can choose the right stream for their use case and DNF makes sure that: + +* The right versions of packages get installed. +* Updating the system also updates the packages within the module streams to their latest versions. +* Updating the system will never cause a module to skip to another stream, even when there are newer versions available. Changing streams is always a conscious decision the user explicitly makes. + +Should users choose not to bother with modules and streams, they always get the distribution default. This means that modularity can be used without any changes to the existing workflows. + +Also, *upgrading an existing Fedora installation won’t require any special steps* as there are no changes to the main Fedora repository. The new content is in a separate repository that is completely optional. + +[[select-modularity-benefits]] +== What are the benefits? + +Different users have different needs. Developers want the latest versions possible, system administrators want stability for longer period of time. + +Modularity makes some parts of the system to move slowly, and other parts to move faster — so users can choose the right speed of different parts according to their use case. + +[[select-modularity-next-steps]] +== Next steps + +Modules can have independent lifecycles from the base Fedora release. Starting next release, it will be possible to build modules against multiple Fedora releases thanks to the link:++https://fedoraproject.org/wiki/Infrastructure/Factory2/Focus/StreamExpansion++[Stream Expansion functionality]. + +That means users will be able to upgrade to the new Fedora version while keeping the streams of software they need for their applications. This will be particularly useful for Fedora Server. \ No newline at end of file diff --git a/modules/release-notes/pages/sysadmin/Security.adoc b/modules/release-notes/pages/sysadmin/Security.adoc new file mode 100644 index 0000000..ca9669a --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Security.adoc @@ -0,0 +1,71 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-security]] += Security + + +== Updated cryptography settings + +With this update, the default Fedora policy regarding cryptographic components has been updated to disallow the use of algorithms that are no longer considered secure. Specifically, the changes involve: + +* Require RSA of 2048 bits or more +* Disable DSA + + +== Libcurl switches from libssh2 to libssh + +With this update, the *libcurl* library switches from using *libssh2* to implement the SSH layer of SCP and SFTP protocols to *libssh*. The reason for the change is that the *libssh2* library uses outdated cryptographic algorithms and lacks important features, such as GSS-API authentication. The newly used *libssh* library is more secure, feature-complete, and with more active upstream community. + + +== NSS uses SQL as default file format + +In Fedora 28, the default file format used by the *NSS* library is changed to SQL. + +The Network Security Services (NSS) library, which is used by Mozilla Firefox, Gnome Evolution, Mozilla Thunderbird, and other applications, changed its default database format for storing keys, certificates, and trust information. The new database format is based on SQlite and uses the filenames `cert9.db`, `key4.db`, and `pkcs11.txt`. The previous database format used Berkeyley DB (DBM) and filenames `cert8.db`, `key3.db`, and `secmod.db`. + +The primary benefit of the SQlite storage is support for concurrent access by multiple applications. When using the previous default file format based on DBM, accidental concurrent access could result in corrupted storage. + +Unless an application explicitly requests either the DBM or SQL format, the NSS library will automatically migrate the application's NSS database from the old to the new format. The old database files will not be updated further. Most users should not experience differences in operation. Applications that perform many NSS read/write operations may experience a minor performance decrease. Use the following command to trigger an explicit migration: + +---- +certutil -d sql: -N -f \ + -@ +---- + +Users who store their system home or application data directory on a network filesystem are advised to set the `NSS_SDB_USE_CACHE=yes` environment variable prior to starting applications that use NSS. Without setting this environment variable, users of network filesystems may experience a major slowdown with some applications, such as Firefox. The environment variable enables the use of a caching strategy in NSS that works around the slowness of network filesystems. Because this caching strategy causes a performance decrease on fast filesystems. + +Additional technical details can be found in the Fedora Wiki: link:https://fedoraproject.org/wiki/Changes/NSSDefaultFileFormatSql[]. + + +== Deprecate TCP wrappers + +Fedora 28 https://fedoraproject.org/wiki/Changes/Deprecate_TCP_wrappers[removes support] for `tcp_wrappers` (aka `/etc/hosts.deny` access files) by default from all the network daemons and tools. +The preferred replacements are software firewalld, nftables rules or software specific access rules for more complex filtering. +If your system security depends on `tcp_wrappers` rules, convert them to firewall rules, or set up `tcpd` to do the same job for you. + +== OpenLDAP switches from NSS to OpenSSL + +With this update, the OpenLDAP distribution in Fedora changed from using the *NSS* (or *MozNSS*) library to the *OpenSSL* library for providing cryptographic functions. The switch promises better support from OpenLDAP upstream, which had ceased maintaining the NSS support layer. + + +== OpenLDAP defaults to use only Shared System Certificates + +OpenLDAP clients and server now use the https://fedoraproject.org/wiki/Features/SharedSystemCertificates[system-wide certificate store] by default, instead of `/etc/openldap/certs`. + + +== OpenLDAP drops TCP wrappers support + +Fedora has https://fedoraproject.org/wiki/Changes/Deprecate_TCP_wrappers[deprecated the use of TCP wrappers]. +The OpenLDAP project also https://www.openldap.org/doc/admin24/security.html#TCP%20Wrappers[discourages their use] and recommends that an IP firewall is used instead. +With this update, OpenLDAP will not be configured with `--enable-wrappers` and so any TCP wrappers configuration will have no effect on OpenLDAP. +Other means should be used to protect the OpenLDAP server. + + +== Replace authconfig with authselect + +Fedora 28 replaces authconfig with authselect as the default tool for generating PAM configuration files and nsswitch.conf. +On new installations, authselect, together with an authconfig compatibility tool, will be installed by default instead of authconfig. +On upgraded installations, authconfig will be replaced with authselect and the compatibility tool but the configuration generated by authconfig will be left intact. +The authconfig compatibility tool will be removed from Fedora in a future release. +The https://github.com/pbrezina/authselect/tree/master/src/man/authselect-migration.7.txt.in.in[authselect-migration(7)] man page explains how to migrate from authconfig to authselect. diff --git a/modules/release-notes/pages/sysadmin/System_Utilities.adoc b/modules/release-notes/pages/sysadmin/System_Utilities.adoc new file mode 100644 index 0000000..6f09791 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/System_Utilities.adoc @@ -0,0 +1,15 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-utilities]] += System Utilities + +[[sect-utilities-time]] +== GNU time 1.8 + +The time command runs another program, then displays information about the resources used by that program. +This version of time has changed the default output format. +If the measured command fails, time will report about it on the first line of standard error output. +This report can be suppressed by using the -q option. +The POSIX mode (-p option) is unchanged. +Users are advised to review their scripts for make sure they can parse the new time output. diff --git a/modules/release-notes/pages/sysadmin/Virtualization.adoc b/modules/release-notes/pages/sysadmin/Virtualization.adoc new file mode 100644 index 0000000..b4b05bd --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Virtualization.adoc @@ -0,0 +1,18 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-virtualization]] += Virtualization + +[[sect-virtualbox]] +== VirtualBox Guest Integration + +The _kernel_ package now includes the vboxguest driver for Virtual Box Guest integration. +The `virtualbox-guest-additions` package, which provides support for better integration of VirtualBox guests with the host, is also included. +Features include: + +* Automatic resizing of the guest desktop-resolution to the vm's window-size +* Seamless mode support (only show guest windows, hide guest background) +* Copy and paste between guest and host + +All of these features are enabled by default in Fedora Workstation. diff --git a/modules/release-notes/pages/sysadmin/Xorg.adoc b/modules/release-notes/pages/sysadmin/Xorg.adoc new file mode 100644 index 0000000..5bbc98c --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Xorg.adoc @@ -0,0 +1,5 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-x-org]] += X.Org diff --git a/modules/release-notes/pages/welcome/Feedback.adoc b/modules/release-notes/pages/welcome/Feedback.adoc new file mode 100644 index 0000000..5e12981 --- /dev/null +++ b/modules/release-notes/pages/welcome/Feedback.adoc @@ -0,0 +1,21 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-Release_Notes-Feedback]] += Feedback + +Thank you for taking the time to provide your comments, suggestions, and bug reports to the Fedora community; this helps improve the state of Fedora, Linux, and free software worldwide. + +== Providing Feedback on Fedora Software + +To provide feedback on Fedora software or other system elements, please refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common F26 Bugs] on the wiki. + +== Providing Feedback on Release Notes + +If you feel these release notes could be improved in any way, you can provide your feedback directly to the beat writers. There are several ways to provide feedback, in order of preference: + +* If you have a Fedora account, edit content directly at link:++http://fedoraproject.org/wiki/Docs/Beats++[Docs-Beats] page on the wiki. + +* Fill out a bug request using link:{BZURL}[http://pagure.io/] - *This link is ONLY for feedback on the release notes themselves.* Refer to the admonition above for details. + +* E-mail the Release-Note mailing list at link:mailto:relnotes@fedoraproject.org[relnotes@fedoraproject.org]. diff --git a/modules/release-notes/pages/welcome/Hardware_Overview.adoc b/modules/release-notes/pages/welcome/Hardware_Overview.adoc new file mode 100644 index 0000000..0e13d49 --- /dev/null +++ b/modules/release-notes/pages/welcome/Hardware_Overview.adoc @@ -0,0 +1,79 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-hardware-overview]] += Hardware Overview + +Fedora {PRODVER} provides software to suit a wide variety of applications. The storage, memory and processing requirements vary depending on usage. For example, a high traffic database server requires much more memory and storage than a business desktop, which in turn has higher requirements than a single-purpose virtual machine. + +[[hardware_overview-specs]] +== Minimum System Configuration + +The figures below are a recommended minimum for the default installation. Your requirements may differ, and most applications will benefit from more than the minimum resources. + +* 1GHz or faster processor + +* 1GB System Memory + +* 10GB unallocated drive space + +.Low memory installations +[NOTE] +==== +Fedora {PRODVER} can be installed and used on systems with limited resources for some applications. Text, VNC, or kickstart installations are advised over graphical installation for systems with very low memory. Larger package sets require more memory during installation, so users with less than 768MB of system memory may have better results preforming a minimal install and adding to it afterward. + +For best results on systems with less than 1GB of memory, use the DVD installation image. +==== + +[[hardware_overview-resolution]] +== Display resolution + +.Graphical Installation requires 800x600 resolution or higher +[NOTE] +==== +Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation. + +Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation. +==== + +[[hardware_overview-graphics]] +== Graphics Hardware + +[[hardware_overview-graphics-legacy_gpus]] +=== Minimum Hardware for Accelerated Desktops + +Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration: + +* Intel prior to GMA9xx + +* NVIDIA prior to NV30 (GeForce FX5xxx series) + +* Radeon prior to R300 (Radeon 9500) + +[[hardware_overview-graphics-cpu_acceleration]] +=== CPU Accelerated Graphics + +Systems with older or no graphics acceleration devices can have accelerated desktop environments using *LLVMpipe* technology, which uses the CPU to render graphics. *LLVMpipe* requires a processor with `SSE2` extensions. The extensions supported by your processor are listed in the `flags:` section of `/proc/cpuinfo` + +[[hardware_overview-graphics-desktops]] +=== Choosing a Desktop Environment for your hardware + +Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. + +Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command: + +---- +# dnf grouplist -v hidden | grep desktop +---- + +Install the desired group: + +---- +# dnf groupinstall "KDE Plasma Workspaces" +---- + +Or, use the short group name to install: + +---- +# dnf install @mate-desktop-environment +---- diff --git a/modules/release-notes/pages/welcome/Overview.adoc b/modules/release-notes/pages/welcome/Overview.adoc new file mode 100644 index 0000000..5e20004 --- /dev/null +++ b/modules/release-notes/pages/welcome/Overview.adoc @@ -0,0 +1,9 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-overview]] += Overview + +As always, Fedora continues to develop and integrate the latest free and open source software. The following sections provide a brief overview of major changes from the last release of Fedora. + +More detailed information about changes in this release can be found on the link:https://fedoraproject.org/wiki/Releases/{PRODVER}/ChangeSet[Fedora Project Wiki]. diff --git a/modules/release-notes/pages/welcome/Welcome.adoc b/modules/release-notes/pages/welcome/Welcome.adoc new file mode 100644 index 0000000..8e77058 --- /dev/null +++ b/modules/release-notes/pages/welcome/Welcome.adoc @@ -0,0 +1,39 @@ + +include::{partialsdir}/entities.adoc[] + +[[sect-welcome_to_fedora]] += Welcome to Fedora + +The Fedora Project is a partnership of Free software community members from around the globe. The Fedora Project builds open source software communities and produces a Linux distribution called Fedora. + +The Fedora Project's mission is to lead the advancement of Free and open source software and content as a collaborative community. The three elements of this mission are clear: + +* The Fedora Project always strives to lead, not follow. + +* The Fedora Project consistently seeks to create, improve, and spread Free/Libre code and content. + +* The Fedora Project succeeds through shared action on the part of many people throughout our community. + +To find out more general information about Fedora, refer to the following pages, on the Fedora Project Wiki: + +* link:++http://fedoraproject.org/wiki/Overview++[Fedora Overview] + +* link:++http://fedoraproject.org/wiki/FAQ++[Fedora FAQ] + +* link:++http://fedoraproject.org/wiki/Communicate++[Help and Discussions] + +* link:++http://fedoraproject.org/wiki/Join++[Participate in the Fedora Project] + +[[sect-need-help]] +== Need Help? + +There are a number of places you can get assistance should you run into problems. + +If you run into a problem and would like some assistance, go to link:++http://ask.fedoraproject.org++[]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too. + +You may also find assistance on the `#fedora` channel on the IRC net `irc.freenode.net`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available. + +[[sect-providing-help]] +== Want to Contribute? + +You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation. diff --git a/preview.sh b/preview.sh new file mode 100755 index 0000000..acab783 --- /dev/null +++ b/preview.sh @@ -0,0 +1,18 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "The preview will be available at http://localhost:8080/" + docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." + echo "The preview will be available at http://localhost:8080/" + sudo docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx +fi diff --git a/site.yml b/site.yml new file mode 100644 index 0000000..4ff9e4d --- /dev/null +++ b/site.yml @@ -0,0 +1,22 @@ +site: + title: Local Preview + start_page: fedora:release-notes:index +content: + sources: + - url: https://pagure.io/forks/bex/fedora-docs/docs-fp-o.git + branches: antora_f28 + - url: . + branches: HEAD +ui: + bundle: + url: https://asamalik.fedorapeople.org/ui-bundle.zip + snapshot: true + default_layout: with_menu +output: + clean: true + dir: ./public + destinations: + - provider: archive +runtime: + pull: true + cache_dir: ./cache From 49b161579c9d129003340433d8cddccd2ffe213d Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jul 28 2018 10:57:59 +0000 Subject: [PATCH 2/3] make the nav work with other guides nicely --- diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 3a6baa3..94abba3 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -1,34 +1,33 @@ -* xref:index.adoc[Book Information] -* Welcome to Fedora +* xref:index.adoc[Fedora Release Notes] ** xref:welcome/Welcome.adoc[Welcome to Fedora] -** xref:welcome/Overview.adoc[Overview] -** xref:welcome/Hardware_Overview.adoc[Hardware Overview] -** xref:welcome/Feedback.adoc[Feedback] -* Changes in Fedora for System Administrators -** xref:sysadmin/Modularity.adoc[Fedora Add-On Modularity] -** xref:sysadmin/Kernel.adoc[Kernel] -** xref:sysadmin/Installation.adoc[Installation] -** xref:sysadmin/Security.adoc[Security] -** xref:sysadmin/Automation.adoc[Automation] -** xref:sysadmin/Virtualization.adoc[Virtualization] -** xref:sysadmin/Mail_Servers.adoc[Mail Servers] -** xref:sysadmin/Xorg.adoc[X.Org] -** xref:sysadmin/System_Utilties.adoc[System Utilties] -* Changes in Fedora for Desktop Users -** xref:desktop/Desktop.adoc[Desktop] -** xref:desktop/Networking.adoc[Networking] -** xref:desktop/I18n.adoc[Internationalization] -* Changes in Fedora for Developers -** xref:developers/Development_Tools.adoc[Development Tools] -** xref:developers/Development_C.adoc[C] -** xref:developers/Containers.adoc[Containers] -** xref:developers/Development_Boost.adoc[Boost] -** xref:developers/Development_D.adoc[D] -** xref:developers/Development_Erlang.adoc[Erlang] -** xref:developers/Development_Go.adoc[Go] -** xref:developers/Development_Haskell.adoc[Haskell] -** xref:developers/Development_Python.adoc[Python] -** xref:developers/Development_Ruby.adoc[Ruby] -** xref:developers/Development_Rust.adoc[Rust] -** xref:developers/Development_Web.adoc[Web Development] -* xref:Revision_History.adoc[Revision History] +*** xref:welcome/Overview.adoc[Overview] +*** xref:welcome/Hardware_Overview.adoc[Hardware Overview] +*** xref:welcome/Feedback.adoc[Feedback] +** System Administrators +*** xref:sysadmin/Modularity.adoc[Fedora Add-On Modularity] +*** xref:sysadmin/Kernel.adoc[Kernel] +*** xref:sysadmin/Installation.adoc[Installation] +*** xref:sysadmin/Security.adoc[Security] +*** xref:sysadmin/Automation.adoc[Automation] +*** xref:sysadmin/Virtualization.adoc[Virtualization] +*** xref:sysadmin/Mail_Servers.adoc[Mail Servers] +*** xref:sysadmin/Xorg.adoc[X.Org] +*** xref:sysadmin/System_Utilities.adoc[System Utilities] +** Desktop Users +*** xref:desktop/Desktop.adoc[Desktop] +*** xref:desktop/Networking.adoc[Networking] +*** xref:desktop/I18n.adoc[Internationalization] +** Developers +*** xref:developers/Development_Tools.adoc[Development Tools] +*** xref:developers/Development_C.adoc[C] +*** xref:developers/Containers.adoc[Containers] +*** xref:developers/Development_Boost.adoc[Boost] +*** xref:developers/Development_D.adoc[D] +*** xref:developers/Development_Erlang.adoc[Erlang] +*** xref:developers/Development_Go.adoc[Go] +*** xref:developers/Development_Haskell.adoc[Haskell] +*** xref:developers/Development_Python.adoc[Python] +*** xref:developers/Development_Ruby.adoc[Ruby] +*** xref:developers/Development_Rust.adoc[Rust] +*** xref:developers/Development_Web.adoc[Web Development] +** xref:Revision_History.adoc[Revision History] From 7ab28ce3ce2b9b9907abe33dcfc4279e6b644b4f Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jul 28 2018 12:50:57 +0000 Subject: [PATCH 3/3] add readme --- diff --git a/README.md b/README.md new file mode 100644 index 0000000..82ad1f6 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# Fedora Modularity Docs + +Please report Issues and submit Pull Requests for **Content Fixes** here. +Never done a pull request (or "PR")? Here's the [Pagure documentation for +Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html). + + +General appearance issues and publishing issues should be reported against +the [publishing software](https://pagure.io/fedora-docs/docs-fp-o). + +## How to edit these documents + +All of this is written in AsciiDoc. It's a simple mostly-plain-text +markup language. You may want to look at: + + +* [AsciiDoc Syntax Quick Reference](http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/) +* [AsciiDoc Writer’s Guide](http://asciidoctor.org/docs/asciidoc-writers-guide/) +* [Antora Documentation](https://docs.antora.org/antora/1.0/page/) + + +## Local preview + +This repo includes scripts to build and preview the contents of this repository. + +**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions. + +Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions. + +To build and preview the site, run: + +``` +$ ./build.sh && ./preview.sh +``` + +The result will be available at http://localhost:8080 + +### Installing docker on Fedora + +``` +$ sudo dnf install docker +$ sudo systemctl start docker && sudo systemctl enable docker +```