From 48005f9009b454c259bfc1b495da949f83a47c87 Mon Sep 17 00:00:00 2001 From: Josh Preston Date: Sun, 6 Mar 2016 14:31:53 -0500 Subject: [PATCH 1/2] generate html docs from md files use markdown to autogenerate documentation from the md files --- FedBerry-INSTALL.html | 44 ------------------------------------- FedBerry-README.html | 37 ------------------------------- FedBerry-RELEASE-NOTES.html | 35 ----------------------------- fedberry-release.spec | 10 ++++++--- 4 files changed, 7 insertions(+), 119 deletions(-) delete mode 100644 FedBerry-INSTALL.html delete mode 100644 FedBerry-README.html delete mode 100644 FedBerry-RELEASE-NOTES.html diff --git a/FedBerry-INSTALL.html b/FedBerry-INSTALL.html deleted file mode 100644 index 9784563..0000000 --- a/FedBerry-INSTALL.html +++ /dev/null @@ -1,44 +0,0 @@ - - - - - -INSTALL - - -

SD CARD INSTALLATION

-

Download images here: http://fedberry.agrez.net

-

The image can be installed using the Unix/Linux dd command.

-

Requirements:

- -

Steps:

-
    -
  1. -

    Download the image and ensure you have not got a corrupted disk image by running sha256sum on the file and checking it against provided checksums.

    -

    For example:

    -

    $ sha256sum fedora-23-remix-rpi2-minimal-1.raw.xz

    -

    OR

    -

    $ sha256sum -c fedora-23-remix-rpi2.CHECKSUM

    -
    2. -
  2. -

    Insert your sd card and determine which device node has been assigned to your media. Read /var/log/messages or run 'dmesg' 'to learn which device was assigned to your media (this will be something like /dev/sdc or /dev/mmcblk0).

    -
    3. -
  3. -

    As root user or 'sudo', use 'dd' to write the disk image to your SD card.

    -

    PLEASE NOTE that the use of the 'dd' tool can overwrite ANY partition on your computer. If you specify the wrong device you could delete all your existing linux partitions. Make sure you KNOW what you are doing here otherwise don't do it or ask someone else who does! Please be VERY careful!

    -

    Ensure the device is unmounted then copy the image file to the card: xzcat NameOfImageFile | dd of=/dev/DeviceNode

    -

    For example:

    -

    $ xzcat fedora-23-remix-rpi2-minimal-1.raw.xz | dd of=/dev/sdc

    -
    4. -
  4. -

    Run 'sync'; this will ensure the write cache is flushed and that it is safe to unmount and remove your SD card from the card reader.

    -
    5. -
- - diff --git a/FedBerry-README.html b/FedBerry-README.html deleted file mode 100644 index b97cae1..0000000 --- a/FedBerry-README.html +++ /dev/null @@ -1,37 +0,0 @@ - - - - - -README - - -

fedberry FedBerry - Fedora Remix for Raspberry Pi 2

-

IMPORTANT INFORMATION

-

These are Fedora® Remix disk images specifically built for use with the Raspberry Pi® 2 (RPi2) computer. These disk images are unofficial Fedora Remixes and are not afiliated, provided or supported by the Fedora Project. Official, unmodified Fedora software is available through the Fedora Project website http://fedoraproject.org. *^

-

Installation

-

Download images here: http://fedberry.agrez.net

-

Please read INSTALL.md

-

First Boot

-

Minimal and XFCE release images

-

The root partition is automatically re-sized when the OS is first booted. After re-sizing, it will automatically reboot. After rebooting the system will launch the 'initial-setup' utility. For graphical images this will occur on the display, for minimal images this will occur on the serial console. Failure to complete the initial-setup will prevent logging into the system.

-

Mini release image

-

The root partition is NOT automatically re-sized at boot due to boot time and image size considerations. The initial-setup utility is not used for this release.

-

Default User / Passwords

-

Minimal and XFCE release images

-

No root password or users are set by default. After the initial OS boot, please set the timezone, root password and create users when prompted at initial setup.

-

Mini release image

-

To facilitate default headless support, a root user password is already set. Please remember to change the root password after the first boot.

-

Root password = fedberry

-

A default user of 'raspberry' is also created but password change is required after the first login.

-

User password = raspberry

-

Additional or Modified Software

-

Our Yum repository is located here: https://vaughan.fedorapeople.org

-

As this is a Fedora Remix, some additional or modified RPMs are included to enable full compatibility with the BCM2836 SOC (RPi2) or to add extra features. The most significant change is a custom kernel. The included kernel has vanilla kernel.org sources patched with modications from the Raspberry Pi foundation's kernel tree (bcm2709 port). Refer here: https://github.com/raspberrypi/linux.

-

All software sources for the RPMs can be found in our githib repositories (https://github.com/fedberry) or the provided SRPMs here: https://vaughan.fedorapeople.org/fed23/SRPMS

-

DISCLAIMER

-

All software provided on this site are being offered for FREE in hopes that they will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Use at your OWN RISK AND WE DISCLAIM LIABILITY FOR ANY DAMAGES RESULTING FROM ITS USE.

-

*Fedora and the Infinity design logo are trademarks of Red Hat, Inc.

-

^Raspberry Pi is a trademark of the Raspberry Pi Foundation

- - diff --git a/FedBerry-RELEASE-NOTES.html b/FedBerry-RELEASE-NOTES.html deleted file mode 100644 index 0c0eeb7..0000000 --- a/FedBerry-RELEASE-NOTES.html +++ /dev/null @@ -1,35 +0,0 @@ - - - - - -RELEASE-NOTES - - -

Minimal & XFCE Remixes

-

Both these remixes are close to 'stock' arm releases from Fedora*. Where possible, they endeavor to stick to default Fedora release settings.

-

Mini Remix

-

This remix differs significantly from default Fedora settings used in their arm releases. It is a small 'bare bones' remix with some optimisations specifically tailored towards Rapsberry^ Pi 2 (RPi2) usage. Its main goals are to have a small footprint, fast boot times and to reduce the number of writes to the SD card (within reason).

-

To achieve these goals, sacrifices were made. For example, included language supoort is limited to en_US and security related features such as selinux or firewalld are disabled / removed. Therefore, it is not advisable to run services that are directly exposed to the internet, rather it should be safely tucked away behind a NAT firewall or something similar.

-

Major changes include:

- -

For a detailed list of changes, as compared to the 'minimal' & 'xfce releases', please refer to the f23-rpi2-mini-remix.ks kickstart file.

-

*Fedora and the Infinity design logo are trademarks of Red Hat, Inc.

-

^Raspberry Pi is a trademark of the Raspberry Pi Foundation

- - diff --git a/fedberry-release.spec b/fedberry-release.spec index 76634bd..a97e789 100644 --- a/fedberry-release.spec +++ b/fedberry-release.spec @@ -8,14 +8,15 @@ Release: 0.8 License: MIT Group: System Environment/Base Source0: LICENSE -Source1: FedBerry-RELEASE-NOTES.html +Source1: https://raw.githubusercontent.com/fedberry/fedberry/master/RELEASE-NOTES.md Source2: Fedora-Legal-README.txt Source3: 85-display-manager.preset Source4: 90-default.preset Source5: 99-default-disable.preset -Source6: FedBerry-README.html -Source7: FedBerry-INSTALL.html +Source6: https://raw.githubusercontent.com/fedberry/fedberry/master/README.md +Source7: https://raw.githubusercontent.com/fedberry/fedberry/master/INSTALL.md BuildArch: noarch +BuildRequires: discount >= 2.1 Obsoletes: redhat-release Provides: redhat-release Provides: system-release @@ -46,6 +47,9 @@ FedBerry release notes package. cp -a %{SOURCE0} %{SOURCE1} %{SOURCE2} %{SOURCE3} %{SOURCE4} %{SOURCE5} %{SOURCE6} %{SOURCE7} . %build +for MD_FILE in *.md; do + markdown -o FedBerry-${MD_FILE%.*}.html ${MD_FILE} +done %install install -d %{buildroot}/etc From 6bdbec096c92df00935ed10b5d5c01268ac5b1d8 Mon Sep 17 00:00:00 2001 From: Josh Preston Date: Sun, 6 Mar 2016 14:58:00 -0500 Subject: [PATCH 2/2] bamp to release 0.9 bumping to release 0.9 * autogenerate html documentation from md files --- fedberry-release.spec | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/fedberry-release.spec b/fedberry-release.spec index a97e789..8ab550a 100644 --- a/fedberry-release.spec +++ b/fedberry-release.spec @@ -4,7 +4,7 @@ Summary: FedBerry release files Name: fedberry-release Version: 23 -Release: 0.8 +Release: 0.9 License: MIT Group: System Environment/Base Source0: LICENSE @@ -119,6 +119,9 @@ rm -rf %{buildroot} %doc FedBerry-RELEASE-NOTES.html FedBerry-INSTALL.html %changelog +* Sun Mar 06 2016 mrjoshuap - 23-0.9 +- Autogenerate html docs from md files + * Thu Jan 28 2016 Vaughan - 23-0.8 - Import & initial build for FedBerry