From c91f5ae02df7cfc190d025d81afef4f4d2e24e0c Mon Sep 17 00:00:00 2001
From: Ernesto Baschny <ernesto.baschny@typo3.org>
Date: Wed, 1 Jun 2011 20:58:47 +0200
Subject: [PATCH] [TASK] Overwork typo3/sysext/README.txt

Change-Id: Ie76570ebce5ea227a947132180e8555c79fbcc48
Resolves: #27173
Reviewed-on: http://review.typo3.org/2494
Reviewed-by: Mario Rimann
Tested-by: Mario Rimann
Reviewed-by: Steffen Gebert
Tested-by: Steffen Gebert
---
 typo3/sysext/README.txt | 47 ++++++++++++++++++++++++++++++++---------
 1 file changed, 37 insertions(+), 10 deletions(-)

diff --git a/typo3/sysext/README.txt b/typo3/sysext/README.txt
index 151a9e45ca88..34a3a2cb395f 100644
--- a/typo3/sysext/README.txt
+++ b/typo3/sysext/README.txt
@@ -1,13 +1,40 @@
-typo3/sysext/
+*******************************************************************************
+System Extensions for TYPO3
+*******************************************************************************
 
-"System" extensions for TYPO3
-This is also a global repository for extensions in TYPO3, just like the global extensions (in typo3/ext/)
-System extensions cannot (by default at least) be updated like global and local extensions; They are meant to always be distributed with the core (while global extensions
-in ext/ are not) and to the user they will probably be understood more like a part of the core since they come along with the core. But technically they are extensions for various reasons.
+This document is a part of the TYPO3 project. TYPO3 is an open source web
+content management system released under the GNU GPL. TYPO3 is copyright
+(c) 1999-2011 by Kasper Skaarhoj.
 
-System Extensions are in the TYPO3core SVN module.
-System Extensions should be hidden in TER (last check of this was oct. 2005 by kasper)
+This document provides information about the content of the typo3/sysext
+folder.
 
-System extensions with manuals are currently (oct 2005):
-- css_styled_content
-- indexed_search
+===============================================================================
+Content
+===============================================================================
+
+This is the repository for extensions which are shipped with the core. They are
+regular extensions with the difference that they are not available on the TYPO3
+Extension Repository (ter), but instead are part of the Core packages.
+
+Since they are shipped with the TYPO3 core (typo3_src package), their content
+will change when updating the core. They are packaged together with the core
+by the release team, so updating the core will update these extensions too.
+
+===============================================================================
+Git Repositories
+===============================================================================
+
+Most of these extensions are developed by the core team itself and are
+maintained directly in the main Core Git repository:
+
+http://git.typo3.org/TYPO3v4/Core.git
+
+Some of the extensions are developed by external teams (e.g. dbal, version,
+workspaces) and are thus maintained in separate Git repositories and linked
+into the core as submodules.
+
+In order to retrieve them together with the core, issue these commands:
+
+git pull
+git submodule update --init
\ No newline at end of file
-- 
GitLab