[PATCH] Convert README to README.md

[PATCH] Convert README to README.md

[Petr Lautrbach]

It should make the document readable for github users.

Fixes: https://github.com/SELinuxProject/selinux/issues/225

Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
---
 README    | 25 -------------------------
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+), 25 deletions(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index e4423ca23b58..000000000000
--- a/README
+++ /dev/null
@@ -1,25 +0,0 @@
-Please submit all bug reports and patches to selinux@vger.kernel.org.
-Subscribe by sending "subscribe selinux" in the body of an email
-to majordomo@vger.kernel.org.
-
-Build dependencies on Fedora:
-yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
-
-To build and install everything under a private directory, run:
-make DESTDIR=~/obj install install-pywrap
-
-To install as the default system libraries and binaries
-(overwriting any previously installed ones - dangerous!),
-on x86_64, run:
-make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
-or on x86 (32-bit), run:
-make install install-pywrap relabel
-
-This may render your system unusable if the upstream SELinux userspace
-lacks library functions or other dependencies relied upon by your
-distribution.  If it breaks, you get to keep both pieces.
-
-To install libsepol on macOS (mainly for policy analysis):
-cd libsepol; make PREFIX=/usr/local install
-
-This requires GNU coreutils (brew install coreutils).
diff --git a/README.md b/README.md
new file mode 100644
index 000000000000..b05f1c74f279
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+SELinux Userspace
+=================
+
+Please submit all bug reports and patches to <selinux@vger.kernel.org>.
+
+Subscribe by sending "subscribe selinux" in the body of an email
+to <majordomo@vger.kernel.org>.
+
+Installation
+------------
+
+Build dependencies on Fedora:
+    
+	yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
+
+
+To build and install everything under a private directory, run:
+
+    make DESTDIR=~/obj install install-pywrap
+
+To install as the default system libraries and binaries
+(overwriting any previously installed ones - dangerous!),
+on x86_64, run:
+
+    make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
+
+or on x86 (32-bit), run:
+
+    make install install-pywrap relabel
+
+This may render your system unusable if the upstream SELinux userspace
+lacks library functions or other dependencies relied upon by your
+distribution.  If it breaks, you get to keep both pieces.
+
+To install libsepol on macOS (mainly for policy analysis):
+
+    cd libsepol; make PREFIX=/usr/local install
+
+This requires GNU coreutils:
+
+    brew install coreutils
-- 
2.26.0

Re: [PATCH] Convert README to README.md

[Paul Moore]

On Thu, Apr 23, 2020 at 9:29 AM Petr Lautrbach <plautrba@redhat.com> wrote:
>
> It should make the document readable for github users.
>
> Fixes: https://github.com/SELinuxProject/selinux/issues/225
>
> Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
> ---
>  README    | 25 -------------------------
>  README.md | 41 +++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 41 insertions(+), 25 deletions(-)
>  delete mode 100644 README
>  create mode 100644 README.md

...

> --- /dev/null
> +++ b/README.md
> @@ -0,0 +1,41 @@
> +SELinux Userspace
> +=================
> +
> +Please submit all bug reports and patches to <selinux@vger.kernel.org>.
> +
> +Subscribe by sending "subscribe selinux" in the body of an email
> +to <majordomo@vger.kernel.org>.
> +
> +Installation
> +------------
> +
> +Build dependencies on Fedora:
> +
> +       yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config

Other than the different amount of white space on the line above
compared to the other command examples, it looks good to me - thanks
Petr.

> +
> +
> +To build and install everything under a private directory, run:
> +
> +    make DESTDIR=~/obj install install-pywrap
> +
> +To install as the default system libraries and binaries
> +(overwriting any previously installed ones - dangerous!),
> +on x86_64, run:
> +
> +    make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
> +
> +or on x86 (32-bit), run:
> +
> +    make install install-pywrap relabel
> +
> +This may render your system unusable if the upstream SELinux userspace
> +lacks library functions or other dependencies relied upon by your
> +distribution.  If it breaks, you get to keep both pieces.
> +
> +To install libsepol on macOS (mainly for policy analysis):
> +
> +    cd libsepol; make PREFIX=/usr/local install
> +
> +This requires GNU coreutils:
> +
> +    brew install coreutils
> --
> 2.26.0
>


-- 
paul moore
www.paul-moore.com

[PATCH v2] Convert README to README.md

[Petr Lautrbach]

It should make the document readable for github users.

Fixes: https://github.com/SELinuxProject/selinux/issues/225

Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
---

- Fixed indentation in yum command

 README    | 25 -------------------------
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+), 25 deletions(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index e4423ca23b58..000000000000
--- a/README
+++ /dev/null
@@ -1,25 +0,0 @@
-Please submit all bug reports and patches to selinux@vger.kernel.org.
-Subscribe by sending "subscribe selinux" in the body of an email
-to majordomo@vger.kernel.org.
-
-Build dependencies on Fedora:
-yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
-
-To build and install everything under a private directory, run:
-make DESTDIR=~/obj install install-pywrap
-
-To install as the default system libraries and binaries
-(overwriting any previously installed ones - dangerous!),
-on x86_64, run:
-make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
-or on x86 (32-bit), run:
-make install install-pywrap relabel
-
-This may render your system unusable if the upstream SELinux userspace
-lacks library functions or other dependencies relied upon by your
-distribution.  If it breaks, you get to keep both pieces.
-
-To install libsepol on macOS (mainly for policy analysis):
-cd libsepol; make PREFIX=/usr/local install
-
-This requires GNU coreutils (brew install coreutils).
diff --git a/README.md b/README.md
new file mode 100644
index 000000000000..974280f9d14f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+SELinux Userspace
+=================
+
+Please submit all bug reports and patches to <selinux@vger.kernel.org>.
+
+Subscribe by sending "subscribe selinux" in the body of an email
+to <majordomo@vger.kernel.org>.
+
+Installation
+------------
+
+Build dependencies on Fedora:
+
+    yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
+
+
+To build and install everything under a private directory, run:
+
+    make DESTDIR=~/obj install install-pywrap
+
+To install as the default system libraries and binaries
+(overwriting any previously installed ones - dangerous!),
+on x86_64, run:
+
+    make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
+
+or on x86 (32-bit), run:
+
+    make install install-pywrap relabel
+
+This may render your system unusable if the upstream SELinux userspace
+lacks library functions or other dependencies relied upon by your
+distribution.  If it breaks, you get to keep both pieces.
+
+To install libsepol on macOS (mainly for policy analysis):
+
+    cd libsepol; make PREFIX=/usr/local install
+
+This requires GNU coreutils:
+
+    brew install coreutils
-- 
2.26.0

Re: [PATCH v2] Convert README to README.md

[Paul Moore]

On Thu, Apr 23, 2020 at 2:55 PM Petr Lautrbach <plautrba@redhat.com> wrote:
>
> It should make the document readable for github users.
>
> Fixes: https://github.com/SELinuxProject/selinux/issues/225
>
> Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
> ---
>
> - Fixed indentation in yum command
>
>  README    | 25 -------------------------
>  README.md | 41 +++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 41 insertions(+), 25 deletions(-)
>  delete mode 100644 README
>  create mode 100644 README.md

Thanks Petr.  For whatever it's worth, here is my ACK.

Acked-by: Paul Moore <paul@paul-moore.com>

> diff --git a/README b/README
> deleted file mode 100644
> index e4423ca23b58..000000000000
> --- a/README
> +++ /dev/null
> @@ -1,25 +0,0 @@
> -Please submit all bug reports and patches to selinux@vger.kernel.org.
> -Subscribe by sending "subscribe selinux" in the body of an email
> -to majordomo@vger.kernel.org.
> -
> -Build dependencies on Fedora:
> -yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
> -
> -To build and install everything under a private directory, run:
> -make DESTDIR=~/obj install install-pywrap
> -
> -To install as the default system libraries and binaries
> -(overwriting any previously installed ones - dangerous!),
> -on x86_64, run:
> -make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
> -or on x86 (32-bit), run:
> -make install install-pywrap relabel
> -
> -This may render your system unusable if the upstream SELinux userspace
> -lacks library functions or other dependencies relied upon by your
> -distribution.  If it breaks, you get to keep both pieces.
> -
> -To install libsepol on macOS (mainly for policy analysis):
> -cd libsepol; make PREFIX=/usr/local install
> -
> -This requires GNU coreutils (brew install coreutils).
> diff --git a/README.md b/README.md
> new file mode 100644
> index 000000000000..974280f9d14f
> --- /dev/null
> +++ b/README.md
> @@ -0,0 +1,41 @@
> +SELinux Userspace
> +=================
> +
> +Please submit all bug reports and patches to <selinux@vger.kernel.org>.
> +
> +Subscribe by sending "subscribe selinux" in the body of an email
> +to <majordomo@vger.kernel.org>.
> +
> +Installation
> +------------
> +
> +Build dependencies on Fedora:
> +
> +    yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
> +
> +
> +To build and install everything under a private directory, run:
> +
> +    make DESTDIR=~/obj install install-pywrap
> +
> +To install as the default system libraries and binaries
> +(overwriting any previously installed ones - dangerous!),
> +on x86_64, run:
> +
> +    make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
> +
> +or on x86 (32-bit), run:
> +
> +    make install install-pywrap relabel
> +
> +This may render your system unusable if the upstream SELinux userspace
> +lacks library functions or other dependencies relied upon by your
> +distribution.  If it breaks, you get to keep both pieces.
> +
> +To install libsepol on macOS (mainly for policy analysis):
> +
> +    cd libsepol; make PREFIX=/usr/local install
> +
> +This requires GNU coreutils:
> +
> +    brew install coreutils
> --
> 2.26.0
>


-- 
paul moore
www.paul-moore.com

Re: [PATCH v2] Convert README to README.md

[Nicolas Iooss]

On Thu, Apr 23, 2020 at 9:29 PM Paul Moore <paul@paul-moore.com> wrote:
>
> On Thu, Apr 23, 2020 at 2:55 PM Petr Lautrbach <plautrba@redhat.com> wrote:
> >
> > It should make the document readable for github users.
> >
> > Fixes: https://github.com/SELinuxProject/selinux/issues/225
> >
> > Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
> > ---
> >
> > - Fixed indentation in yum command
> >
> >  README    | 25 -------------------------
> >  README.md | 41 +++++++++++++++++++++++++++++++++++++++++
> >  2 files changed, 41 insertions(+), 25 deletions(-)
> >  delete mode 100644 README
> >  create mode 100644 README.md
>
> Thanks Petr.  For whatever it's worth, here is my ACK.
>
> Acked-by: Paul Moore <paul@paul-moore.com>

Thanks :) I will improve the README a little bit more (adding a
Travis-CI badge, listing Debian build dependencies, adding
"install-rubywrap"...) and send a patch to be applied on top of this
one.

Acked-by: Nicolas Iooss <nicolas.iooss@m4x.org>

Nicolas

>
> > diff --git a/README b/README
> > deleted file mode 100644
> > index e4423ca23b58..000000000000
> > --- a/README
> > +++ /dev/null
> > @@ -1,25 +0,0 @@
> > -Please submit all bug reports and patches to selinux@vger.kernel.org.
> > -Subscribe by sending "subscribe selinux" in the body of an email
> > -to majordomo@vger.kernel.org.
> > -
> > -Build dependencies on Fedora:
> > -yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
> > -
> > -To build and install everything under a private directory, run:
> > -make DESTDIR=~/obj install install-pywrap
> > -
> > -To install as the default system libraries and binaries
> > -(overwriting any previously installed ones - dangerous!),
> > -on x86_64, run:
> > -make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
> > -or on x86 (32-bit), run:
> > -make install install-pywrap relabel
> > -
> > -This may render your system unusable if the upstream SELinux userspace
> > -lacks library functions or other dependencies relied upon by your
> > -distribution.  If it breaks, you get to keep both pieces.
> > -
> > -To install libsepol on macOS (mainly for policy analysis):
> > -cd libsepol; make PREFIX=/usr/local install
> > -
> > -This requires GNU coreutils (brew install coreutils).
> > diff --git a/README.md b/README.md
> > new file mode 100644
> > index 000000000000..974280f9d14f
> > --- /dev/null
> > +++ b/README.md
> > @@ -0,0 +1,41 @@
> > +SELinux Userspace
> > +=================
> > +
> > +Please submit all bug reports and patches to <selinux@vger.kernel.org>.
> > +
> > +Subscribe by sending "subscribe selinux" in the body of an email
> > +to <majordomo@vger.kernel.org>.
> > +
> > +Installation
> > +------------
> > +
> > +Build dependencies on Fedora:
> > +
> > +    yum install audit-libs-devel bison bzip2-devel dbus-devel dbus-glib-devel flex flex-devel flex-static glib2-devel libcap-devel libcap-ng-devel pam-devel pcre-devel python3-devel python3-setools swig xmlto redhat-rpm-config
> > +
> > +
> > +To build and install everything under a private directory, run:
> > +
> > +    make DESTDIR=~/obj install install-pywrap
> > +
> > +To install as the default system libraries and binaries
> > +(overwriting any previously installed ones - dangerous!),
> > +on x86_64, run:
> > +
> > +    make LIBDIR=/usr/lib64 SHLIBDIR=/lib64 install install-pywrap relabel
> > +
> > +or on x86 (32-bit), run:
> > +
> > +    make install install-pywrap relabel
> > +
> > +This may render your system unusable if the upstream SELinux userspace
> > +lacks library functions or other dependencies relied upon by your
> > +distribution.  If it breaks, you get to keep both pieces.
> > +
> > +To install libsepol on macOS (mainly for policy analysis):
> > +
> > +    cd libsepol; make PREFIX=/usr/local install
> > +
> > +This requires GNU coreutils:
> > +
> > +    brew install coreutils
> > --
> > 2.26.0
> >
>
>
> --
> paul moore
> www.paul-moore.com

Re: [PATCH v2] Convert README to README.md

[Paul Moore]

On Sun, Apr 26, 2020 at 9:02 AM Nicolas Iooss <nicolas.iooss@m4x.org> wrote:
>
> On Thu, Apr 23, 2020 at 9:29 PM Paul Moore <paul@paul-moore.com> wrote:
> >
> > On Thu, Apr 23, 2020 at 2:55 PM Petr Lautrbach <plautrba@redhat.com> wrote:
> > >
> > > It should make the document readable for github users.
> > >
> > > Fixes: https://github.com/SELinuxProject/selinux/issues/225
> > >
> > > Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
> > > ---
> > >
> > > - Fixed indentation in yum command
> > >
> > >  README    | 25 -------------------------
> > >  README.md | 41 +++++++++++++++++++++++++++++++++++++++++
> > >  2 files changed, 41 insertions(+), 25 deletions(-)
> > >  delete mode 100644 README
> > >  create mode 100644 README.md
> >
> > Thanks Petr.  For whatever it's worth, here is my ACK.
> >
> > Acked-by: Paul Moore <paul@paul-moore.com>
>
> Thanks :) I will improve the README a little bit more (adding a
> Travis-CI badge, listing Debian build dependencies, adding
> "install-rubywrap"...) and send a patch to be applied on top of this
> one.

I think those all sound like good improvements.  Thanks guys.

-- 
paul moore
www.paul-moore.com

Re: [PATCH v2] Convert README to README.md

[Nicolas Iooss]

On Sun, Apr 26, 2020 at 10:54 PM Paul Moore <paul@paul-moore.com> wrote:
>
> On Sun, Apr 26, 2020 at 9:02 AM Nicolas Iooss <nicolas.iooss@m4x.org> wrote:
> >
> > On Thu, Apr 23, 2020 at 9:29 PM Paul Moore <paul@paul-moore.com> wrote:
> > >
> > > On Thu, Apr 23, 2020 at 2:55 PM Petr Lautrbach <plautrba@redhat.com> wrote:
> > > >
> > > > It should make the document readable for github users.
> > > >
> > > > Fixes: https://github.com/SELinuxProject/selinux/issues/225
> > > >
> > > > Signed-off-by: Petr Lautrbach <plautrba@redhat.com>
> > > > ---
> > > >
> > > > - Fixed indentation in yum command
> > > >
> > > >  README    | 25 -------------------------
> > > >  README.md | 41 +++++++++++++++++++++++++++++++++++++++++
> > > >  2 files changed, 41 insertions(+), 25 deletions(-)
> > > >  delete mode 100644 README
> > > >  create mode 100644 README.md
> > >
> > > Thanks Petr.  For whatever it's worth, here is my ACK.
> > >
> > > Acked-by: Paul Moore <paul@paul-moore.com>
> >
> > Thanks :) I will improve the README a little bit more (adding a
> > Travis-CI badge, listing Debian build dependencies, adding
> > "install-rubywrap"...) and send a patch to be applied on top of this
> > one.
>
> I think those all sound like good improvements.  Thanks guys.

I merged the commit and am still preparing improvements (if you are
interested, the work-in-progress is available at
https://github.com/fishilico/selinux/blob/wip/README.md).

Thanks,
Nicolas