Change .doc extension to .txt so people stop asking why we have Word documents. WE DONT THEY ARE TEXT!!!!111eleven

1 files changed, 29 insertions, 0 deletions

diff --git a/docs/globals.txt b/docs/globals.txt
new file mode 100644
index 000000000000..ac1a60916344
--- /dev/null
+++ b/docs/globals.txt
@@ -0,0 +1,29 @@
+GLOBALS.DOC
+
+PHP loves globals. I hate them. This is not a great
+combination, but I manage. I could get rid of most of
+them by having a single "HTTP request" object, and using
+it to hold everything that's now global (which is exactly
+what I'd do in a Java servlet). But that's really
+awkward in PHP, and wouldn't really provide much benefit
+in readability or maintainability, so I go with the flow
+of PHP and use globals.  Here's documentation on the
+important globals used by the system.
+
+$wgOut
+	OutputPage object for HTTP response.
+
+$wgTitle
+	Title object created from the request URL.
+
+$wgLang
+	Language object for this request.
+
+$wgArticle
+	Article object corresponsing to $wgTitle.
+
+$wgLinkCache
+	LinkCache object.
+
+...
+