diff mbox series

[libubootenv] README: rework README file

Message ID 1560183305-19989-1-git-send-email-pjtexier@koncepto.io
State Accepted
Headers show
Series [libubootenv] README: rework README file | expand

Commit Message

'Darko Komljenovic' via swupdate June 10, 2019, 4:15 p.m. UTC
- move extension from rst to md
 - add Travis-ci badge

Signed-off-by: Pierre-Jean Texier <pjtexier@koncepto.io>
---
 README.md  | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.rst | 60 ------------------------------------------------------------
 2 files changed, 62 insertions(+), 60 deletions(-)
 create mode 100644 README.md
 delete mode 100644 README.rst

Comments

Stefano Babic June 10, 2019, 4:57 p.m. UTC | #1
Hi Pierre-Jean,

On 10/06/19 18:15, 'Pierre-Jean Texier' via swupdate wrote:
>  - move extension from rst to md

As github supports .rst files as README, I let .rst as format. Which is
the advantage to switch to md ?

Regards,
Stefano

>  - add Travis-ci badge
> 
> Signed-off-by: Pierre-Jean Texier <pjtexier@koncepto.io>
> ---
>  README.md  | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  README.rst | 60 ------------------------------------------------------------
>  2 files changed, 62 insertions(+), 60 deletions(-)
>  create mode 100644 README.md
>  delete mode 100644 README.rst
> 
> diff --git a/README.md b/README.md
> new file mode 100644
> index 0000000..cb689b7
> --- /dev/null
> +++ b/README.md
> @@ -0,0 +1,62 @@
> +libubootenv - Library to access U-Boot environment
> +==================================================
> +
> +[![Build Status](https://travis-ci.org/sbabic/libubootenv.svg?branch=master)](https://travis-ci.org/sbabic/libubootenv)
> +
> +libubootenv is a library that provides a hardware independent way to access
> +to U-Boot environment. U-Boot has its default environment compiled board-dependently
> +and this means that tools to access the environment are also board specific, too.
> +
> +Source Code: https://github.com/sbabic/libubootenv
> +
> +Documentation (doxygen): https://sbabic.github.io/libubootenv
> +
> +Replacement old tools
> +---------------------
> +
> +Part of the library are the replacement of the "fw_printenv / fw_setenv" tools that
> +can be used with any board - they accept as parameter a file as initial environment if none is found
> +on the persistent storage. The syntax for the file and for the data configuration file
> +is the same as the one described in the U-Boot project.
> +
> +::
> +
> +        Usage fw_printenv [OPTION]
> +         -h,                              : print this help
> +         -c, --config <filename>          : configuration file (old fw_env.config)
> +         -f, --defenv <filename>          : default environment if no one found
> +         -V,                              : print version and exit
> +         -n, --no-header                  : do not print variable name
> +
> +        Usage fw_setenv [OPTION]
> +         -h,                              : print this help
> +         -c, --config <filename>          : configuration file (old fw_env.config)
> +         -f, --defenv <filename>          : default environment if no one found
> +         -V,                              : print version and exit
> +         -s, --script <filename>          : read variables to be set from a script
> +
> +License
> +-------
> +
> +libubootenv is licensed under LGPL-2.1
> +
> +OE / Yocto support
> +------------------
> +
> +Recipe is provided in meta-swupdate layer https://github.com/sbabic/meta-swupdate.git 
> +
> +Buildroot support
> +-----------------
> +
> +Package is provided in https://git.buildroot.net/buildroot/tree/package/libubootenv
> +
> +Contributing to the project
> +---------------------------
> +
> +Contributions are welcome !  You can submit your patches (or post questions
> +regarding the project) to the swupdate Mailing List:
> +
> +	swupdate@googlegroups.com
> +
> +Please read the [contributing](http://sbabic.github.io/swupdate/contributing.html)
> +chapter in the documentation how to contribute to the project.
> diff --git a/README.rst b/README.rst
> deleted file mode 100644
> index cdd04e6..0000000
> --- a/README.rst
> +++ /dev/null
> @@ -1,60 +0,0 @@
> -libubootenv - Library to access U-Boot environment
> -==================================================
> -
> -libubootenv is a library that provides a hardware independent way to access
> -to U-Boot environment. U-Boot has its default environment compiled board-dependently
> -and this means that tools to access the environment are also board specific, too.
> -
> -Source Code: https://github.com/sbabic/libubootenv
> -
> -Documentation (doxygen): https://sbabic.github.io/libubootenv
> -
> -Replacement old tools
> ----------------------
> -
> -Part of the library are the replacement of the "fw_printenv / fw_setenv" tools that
> -can be used with any board - they accept as parameter a file as initial environment if none is found
> -on the persistent storage. The syntax for the file and for the data configuration file
> -is the same as the one described in the U-Boot project.
> -
> -::
> -
> -        Usage fw_printenv [OPTION]
> -         -h,                              : print this help
> -         -c, --config <filename>          : configuration file (old fw_env.config)
> -         -f, --defenv <filename>          : default environment if no one found
> -         -V,                              : print version and exit
> -         -n, --no-header                  : do not print variable name
> -
> -        Usage fw_setenv [OPTION]
> -         -h,                              : print this help
> -         -c, --config <filename>          : configuration file (old fw_env.config)
> -         -f, --defenv <filename>          : default environment if no one found
> -         -V,                              : print version and exit
> -         -s, --script <filename>          : read variables to be set from a script
> -
> -License
> --------
> -
> -libubootenv is licensed under LGPL-2.1
> -
> -OE / Yocto support
> -------------------
> -
> -Recipe is provided in meta-swupdate layer https://github.com/sbabic/meta-swupdate.git 
> -
> -Buildroot support
> ------------------
> -
> -Package is provided in https://git.buildroot.net/buildroot/tree/package/libubootenv
> -
> -Contributing to the project
> ----------------------------
> -
> -Contributions are welcome !  You can submit your patches (or post questions
> -regarding the project) to the swupdate Mailing List:
> -
> -	swupdate@googlegroups.com
> -
> -Please read the [contributing](http://sbabic.github.io/swupdate/contributing.html)
> -chapter in the documentation how to contribute to the project.
>
'Darko Komljenovic' via swupdate June 10, 2019, 5:43 p.m. UTC | #2
Hi Stefano,

Le 10/06/2019 à 18:57, Stefano Babic a écrit :
> As github supports .rst files as README, I let .rst as format. Which is
> the advantage to switch to md ?

Yes, it's right.
But, in fact, it's mainly to be consistent with SWUpdate and keep the
same syntax:)

For example, today we have a display problem on Github with the
"Contributing to the project" part. Because the file is markdown 
oriented, I think.

Thanks,

> 
> Regards,
> Stefano
Stefano Babic June 10, 2019, 6:39 p.m. UTC | #3
On 10/06/19 19:43, 'Pierre-Jean Texier' via swupdate wrote:
> Hi Stefano,
> 
> Le 10/06/2019 à 18:57, Stefano Babic a écrit :
>> As github supports .rst files as README, I let .rst as format. Which is
>> the advantage to switch to md ?
> 
> Yes, it's right.
> But, in fact, it's mainly to be consistent with SWUpdate and keep the
> same syntax:)
> 
> For example, today we have a display problem on Github with the
> "Contributing to the project" part. Because the file is markdown
> oriented, I think.
> 

ok, I will apply this.

Regards,
Stefano

> Thanks,
> 
>>
>> Regards,
>> Stefano
>
'Darko Komljenovic' via swupdate June 10, 2019, 6:40 p.m. UTC | #4
Le 10/06/2019 à 20:39, Stefano Babic a écrit :
> ok, I will apply this.

Thanks Stefano !

> 
> Regards,
> Stefano
diff mbox series

Patch

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cb689b7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@ 
+libubootenv - Library to access U-Boot environment
+==================================================
+
+[![Build Status](https://travis-ci.org/sbabic/libubootenv.svg?branch=master)](https://travis-ci.org/sbabic/libubootenv)
+
+libubootenv is a library that provides a hardware independent way to access
+to U-Boot environment. U-Boot has its default environment compiled board-dependently
+and this means that tools to access the environment are also board specific, too.
+
+Source Code: https://github.com/sbabic/libubootenv
+
+Documentation (doxygen): https://sbabic.github.io/libubootenv
+
+Replacement old tools
+---------------------
+
+Part of the library are the replacement of the "fw_printenv / fw_setenv" tools that
+can be used with any board - they accept as parameter a file as initial environment if none is found
+on the persistent storage. The syntax for the file and for the data configuration file
+is the same as the one described in the U-Boot project.
+
+::
+
+        Usage fw_printenv [OPTION]
+         -h,                              : print this help
+         -c, --config <filename>          : configuration file (old fw_env.config)
+         -f, --defenv <filename>          : default environment if no one found
+         -V,                              : print version and exit
+         -n, --no-header                  : do not print variable name
+
+        Usage fw_setenv [OPTION]
+         -h,                              : print this help
+         -c, --config <filename>          : configuration file (old fw_env.config)
+         -f, --defenv <filename>          : default environment if no one found
+         -V,                              : print version and exit
+         -s, --script <filename>          : read variables to be set from a script
+
+License
+-------
+
+libubootenv is licensed under LGPL-2.1
+
+OE / Yocto support
+------------------
+
+Recipe is provided in meta-swupdate layer https://github.com/sbabic/meta-swupdate.git 
+
+Buildroot support
+-----------------
+
+Package is provided in https://git.buildroot.net/buildroot/tree/package/libubootenv
+
+Contributing to the project
+---------------------------
+
+Contributions are welcome !  You can submit your patches (or post questions
+regarding the project) to the swupdate Mailing List:
+
+	swupdate@googlegroups.com
+
+Please read the [contributing](http://sbabic.github.io/swupdate/contributing.html)
+chapter in the documentation how to contribute to the project.
diff --git a/README.rst b/README.rst
deleted file mode 100644
index cdd04e6..0000000
--- a/README.rst
+++ /dev/null
@@ -1,60 +0,0 @@ 
-libubootenv - Library to access U-Boot environment
-==================================================
-
-libubootenv is a library that provides a hardware independent way to access
-to U-Boot environment. U-Boot has its default environment compiled board-dependently
-and this means that tools to access the environment are also board specific, too.
-
-Source Code: https://github.com/sbabic/libubootenv
-
-Documentation (doxygen): https://sbabic.github.io/libubootenv
-
-Replacement old tools
----------------------
-
-Part of the library are the replacement of the "fw_printenv / fw_setenv" tools that
-can be used with any board - they accept as parameter a file as initial environment if none is found
-on the persistent storage. The syntax for the file and for the data configuration file
-is the same as the one described in the U-Boot project.
-
-::
-
-        Usage fw_printenv [OPTION]
-         -h,                              : print this help
-         -c, --config <filename>          : configuration file (old fw_env.config)
-         -f, --defenv <filename>          : default environment if no one found
-         -V,                              : print version and exit
-         -n, --no-header                  : do not print variable name
-
-        Usage fw_setenv [OPTION]
-         -h,                              : print this help
-         -c, --config <filename>          : configuration file (old fw_env.config)
-         -f, --defenv <filename>          : default environment if no one found
-         -V,                              : print version and exit
-         -s, --script <filename>          : read variables to be set from a script
-
-License
--------
-
-libubootenv is licensed under LGPL-2.1
-
-OE / Yocto support
-------------------
-
-Recipe is provided in meta-swupdate layer https://github.com/sbabic/meta-swupdate.git 
-
-Buildroot support
------------------
-
-Package is provided in https://git.buildroot.net/buildroot/tree/package/libubootenv
-
-Contributing to the project
----------------------------
-
-Contributions are welcome !  You can submit your patches (or post questions
-regarding the project) to the swupdate Mailing List:
-
-	swupdate@googlegroups.com
-
-Please read the [contributing](http://sbabic.github.io/swupdate/contributing.html)
-chapter in the documentation how to contribute to the project.