From f8598162628fd50ba8c921e193864014f69de6dd Mon Sep 17 00:00:00 2001 From: ElectronicsArchiver <85485984+ElectronicsArchiver@users.noreply.github.com> Date: Fri, 11 Mar 2022 10:43:21 -0500 Subject: [PATCH 1/5] Copied README for Markdown --- README.md | 105 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 000000000..da01bfed6 --- /dev/null +++ b/README.md @@ -0,0 +1,105 @@ +FreeType 2.11.1 +=============== + +Homepage: https://www.freetype.org + +FreeType is a freely available software library to render fonts. + +It is written in C, designed to be small, efficient, highly +customizable, and portable while capable of producing high-quality +output (glyph images) of most vector and bitmap font formats. + +Please read the `docs/CHANGES` file, it contains IMPORTANT +INFORMATION. + +Read the files `docs/INSTALL*` for installation instructions; see the +file `docs/LICENSE.TXT` for the available licenses. + +For using FreeType's git repository instead of a distribution bundle, +please read file `README.git`. + +The FreeType 2 API reference is located in directory `docs/reference`; +use the file `index.html` as the top entry point. [Please note that +currently the search function for locally installed documentation +doesn't work due to cross-site scripting issues.] + +Additional documentation is available as a separate package from our +sites. Go to + + https://download.savannah.gnu.org/releases/freetype/ + +and download one of the following files. + + freetype-doc-2.11.1.tar.xz + freetype-doc-2.11.1.tar.gz + ftdoc2111.zip + +To view the documentation online, go to + + https://www.freetype.org/freetype2/docs/ + + +Mailing Lists +------------- + +The preferred way of communication with the FreeType team is using +e-mail lists. + + general use and discussion: freetype@nongnu.org + engine internals, porting, etc.: freetype-devel@nongnu.org + announcements: freetype-announce@nongnu.org + git repository tracker: freetype-commit@nongnu.org + +The lists are moderated; see + + https://www.freetype.org/contact.html + +how to subscribe. + + +Bugs +---- + +Please submit bug reports at + + https://gitlab.freedesktop.org/freetype/freetype/-/issues + +Alternatively, you might report bugs by e-mail to +`freetype-devel@nongnu.org`. Don't forget to send a detailed +explanation of the problem -- there is nothing worse than receiving a +terse message that only says 'it doesn't work'. + + +Patches +------- + +For larger changes please provide merge requests at + + https://gitlab.freedesktop.org/freetype/freetype/-/merge_requests + +Alternatively, you can send patches to the `freetype-devel@nongnu.org` +mailing list -- and thank you in advance for your work on improving +FreeType! + +Details on the process can be found here: + + https://www.freetype.org/developer.html#patches + + +Enjoy! + + The FreeType Team + +---------------------------------------------------------------------- + +Copyright (C) 2006-2022 by +David Turner, Robert Wilhelm, and Werner Lemberg. + +This file is part of the FreeType project, and may only be used, +modified, and distributed under the terms of the FreeType project +license, LICENSE.TXT. By continuing to use, modify, or distribute +this file you indicate that you have read the license and understand +and accept it fully. + + +--- end of README --- -- GitLab From 4c866e3f9b4de41703f555fca9f447997658cebc Mon Sep 17 00:00:00 2001 From: ElectronicsArchiver <85485984+ElectronicsArchiver@users.noreply.github.com> Date: Fri, 11 Mar 2022 10:51:31 -0500 Subject: [PATCH 2/5] Removed Unnecessary Extension --- LICENSE.TXT => LICENSE | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename LICENSE.TXT => LICENSE (100%) diff --git a/LICENSE.TXT b/LICENSE similarity index 100% rename from LICENSE.TXT rename to LICENSE -- GitLab From 6c4706d88ea0277f5cee4a8b50aca0f01c7dfbc6 Mon Sep 17 00:00:00 2001 From: ElectronicsArchiver <85485984+ElectronicsArchiver@users.noreply.github.com> Date: Fri, 11 Mar 2022 15:53:06 -0500 Subject: [PATCH 3/5] Formatted README Content --- README.md | 170 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 105 insertions(+), 65 deletions(-) diff --git a/README.md b/README.md index da01bfed6..c3353ad67 100644 --- a/README.md +++ b/README.md @@ -1,105 +1,145 @@ -FreeType 2.11.1 -=============== -Homepage: https://www.freetype.org +# FreeType ![Badge Version] -FreeType is a freely available software library to render fonts. +*A freely available software library to render fonts.* -It is written in C, designed to be small, efficient, highly -customizable, and portable while capable of producing high-quality -output (glyph images) of most vector and bitmap font formats. +--- -Please read the `docs/CHANGES` file, it contains IMPORTANT -INFORMATION. + **[❮ Website ❯][Website]** + **[❮ Install ❯][Install]** + **[❮ Changes ❯][Changes]** + **[❮ Documentation ❯][Documentation]** + **[❮ API ❯][API]** + **[❮ License ❯][License]** -Read the files `docs/INSTALL*` for installation instructions; see the -file `docs/LICENSE.TXT` for the available licenses. +--- -For using FreeType's git repository instead of a distribution bundle, -please read file `README.git`. +**FreeType** is a **C** library written to produce high
+quality output in the form of glyph images of
+most vector / bitmap font formats while being: -The FreeType 2 API reference is located in directory `docs/reference`; -use the file `index.html` as the top entry point. [Please note that -currently the search function for locally installed documentation -doesn't work due to cross-site scripting issues.] +- **Customizable** +- **Efficient** +- **Portable** +- **Small** -Additional documentation is available as a separate package from our -sites. Go to +--- - https://download.savannah.gnu.org/releases/freetype/ +
-and download one of the following files. +## Documentation - freetype-doc-2.11.1.tar.xz - freetype-doc-2.11.1.tar.gz - ftdoc2111.zip +Check out the [`README.git`][README.Git] for more
+info on how to work with this repository. -To view the documentation online, go to +### Downloads - https://www.freetype.org/freetype2/docs/ +Additional information can be downloaded from the **[Releases]** page. +- [`freetype-doc-2.11.1.tar.xz`][Documentation XZ] +- [`freetype-doc-2.11.1.tar.gz`][Documentation GZ] +- [`ftdoc2111.zip`][Documentation ZIP] +
-Mailing Lists -------------- +--- -The preferred way of communication with the FreeType team is using -e-mail lists. +
- general use and discussion: freetype@nongnu.org - engine internals, porting, etc.: freetype-devel@nongnu.org - announcements: freetype-announce@nongnu.org - git repository tracker: freetype-commit@nongnu.org +## Mailing Lists -The lists are moderated; see +*Our preferred ways of communication are email lists.*
+*↳* [*How do I subscribe?*][Contact] - https://www.freetype.org/contact.html +
-how to subscribe. +#### General / Discussions +[`FreeType@nongnu.org`](mailto:freetype@nongnu.org) -Bugs ----- +#### Engine Internals / Porting -Please submit bug reports at +[`FreeType-Devel@nongnu.org`](mailto:freetype-devel@nongnu.org) - https://gitlab.freedesktop.org/freetype/freetype/-/issues +#### Announcements -Alternatively, you might report bugs by e-mail to -`freetype-devel@nongnu.org`. Don't forget to send a detailed -explanation of the problem -- there is nothing worse than receiving a -terse message that only says 'it doesn't work'. +[`FreeType-Announce@nongnu.org`](mailto:freetype-announce@nongnu.org) +#### Git Repository Tracker -Patches -------- +[`FreeType-Commit@nongnu.org`](mailto:freetype-commit@nongnu.org) -For larger changes please provide merge requests at +
- https://gitlab.freedesktop.org/freetype/freetype/-/merge_requests +***These lists are moderated.*** -Alternatively, you can send patches to the `freetype-devel@nongnu.org` -mailing list -- and thank you in advance for your work on improving -FreeType! +
-Details on the process can be found here: +--- - https://www.freetype.org/developer.html#patches +
+## Bugs -Enjoy! +You can either **[Create An Issue][Issues]** or send
+an email to [`FreeType-Devel@nongnu.org`](mailto:freetype-devel@nongnu.org) - The FreeType Team +***Please don't forget to send a detailed explanation,***
+*there is nothing worse than receiving a terse message*
+*that only says `it doesn't work` .* ----------------------------------------------------------------------- +
-Copyright (C) 2006-2022 by -David Turner, Robert Wilhelm, and Werner Lemberg. +--- -This file is part of the FreeType project, and may only be used, -modified, and distributed under the terms of the FreeType project -license, LICENSE.TXT. By continuing to use, modify, or distribute -this file you indicate that you have read the license and understand -and accept it fully. +
+## Patches ---- end of README --- +Please provide a **[Merge Request]** for larger changes.
+*↳* [*How does the process work?*][Patches] + +*Alternatively, you can send patches to the*
+*[`FreeType-Devel@nongnu.org`](mailto:freetype-devel@nongnu.org) mailing list.* + +***Thank you in advance for your work on improving FreeType!*** + +**Enjoy!**
+ *\- The FreeType Team* + +
+ +--- + +
+ + Copyright (C) 2006 - 2022 by + David Turner, Robert Wilhelm, and Werner Lemberg. + + This file is part of the FreeType project, and may only be used, + modified, and distributed under the terms of the FreeType project + license, LICENSE. By continuing to use, modify, or distribute + this file you indicate that you have read the license and understand + and accept it fully. + + + +[Website]: https://www.freetype.org +[Issues]: https://gitlab.freedesktop.org/freetype/freetype/-/issues +[Contact]: https://www.freetype.org/contact.html +[Merge Request]: https://gitlab.freedesktop.org/freetype/freetype/-/merge_requests +[Patches]: https://www.freetype.org/developer.html#patches +[Documentation]: https://www.freetype.org/freetype2/docs/ +[Releases]: https://download.savannah.gnu.org/releases/freetype/ +[API]: https://freetype.org/freetype2/docs/reference/index.html + +[README.Git]: ./README.git + +[Documentation XZ]: https://download.savannah.gnu.org/releases/freetype/freetype-2.11.1.tar.xz +[Documentation GZ]: https://download.savannah.gnu.org/releases/freetype/freetype-2.11.1.tar.gz +[Documentation ZIP]: https://download.savannah.gnu.org/releases/freetype/ftdmo2111.zip + +[Install]: ./docs/INSTALL +[Changes]: ./docs/CHANGES +[License]: ./LICENSE + +[Badge Version]: https://img.shields.io/badge/version-2.11.1-blue -- GitLab From 51990ff503dc89d687b028c0df5ce8ccc08f39f9 Mon Sep 17 00:00:00 2001 From: ElectronicsArchiver <85485984+ElectronicsArchiver@users.noreply.github.com> Date: Fri, 11 Mar 2022 16:02:50 -0500 Subject: [PATCH 4/5] Revert "Removed Unnecessary Extension" This reverts commit 4c866e3f9b4de41703f555fca9f447997658cebc. --- LICENSE => LICENSE.TXT | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename LICENSE => LICENSE.TXT (100%) diff --git a/LICENSE b/LICENSE.TXT similarity index 100% rename from LICENSE rename to LICENSE.TXT -- GitLab From d9de37ff8798bd1a9541906cf3e1e140e6c86ab3 Mon Sep 17 00:00:00 2001 From: ElectronicsArchiver <85485984+ElectronicsArchiver@users.noreply.github.com> Date: Fri, 11 Mar 2022 16:03:31 -0500 Subject: [PATCH 5/5] License Extension Reversion Fix --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c3353ad67..52a0aee4c 100644 --- a/README.md +++ b/README.md @@ -140,6 +140,6 @@ Please provide a **[Merge Request]** for larger changes.
[Install]: ./docs/INSTALL [Changes]: ./docs/CHANGES -[License]: ./LICENSE +[License]: ./LICENSE.TXT [Badge Version]: https://img.shields.io/badge/version-2.11.1-blue -- GitLab