blender/README

Welcome to the fun world of open-source.

For instructions on building and installing Blender, please see the file named
INSTALL.


---------------------.Blanguages and the .blender directory---------------------

The .blender directory holds various data files for Blender.
In the 2.28a release those are the .Blanguages file containing a list of
translations, the translations themselves and a default ttf font.

Blender checks for the presence of this directory in several locations:
	- the current directory
	- your home directory
	- On OSX, the blender bundle is also checked 
	- On Windows, the installation dir is checked.

If you get a 'File ".Blanguages" not found' warning, try to copy the .blender
dir to one of these locations (your home directory being recommended).


-------------------------------------Links--------------------------------------

Getting Involved:
http://www.blender.org/docs/get_involved.html

Community:
http://www.blender3d.org/Community/

Main blender development site:
http://www.blender.org/

The Blender project homepage:
http://projects.blender.org/projects/bf-blender/

Documentation:
http://www.blender.org/modules.php?op=modload&name=documentation&file=index

Bug tracker:
http://projects.blender.org/tracker/?atid=125&group_id=9&func=browse

Feature request tracker:
http://projects.blender.org/tracker/?atid=128&group_id=9&func=browse
Fixed a bunch of typos. mein@cs.umn.edu 2002-11-04 17:09:40 +00:00			`Welcome to the fun world of open-source.`
I made a little readme to get people started and modified the nan_definitions.mk to setup NANBLENDERHOME and everything is under that directory. also add empty dirs for lib and obj. Try it out and feel free to make improvements. mein@cs.umn.edu 2002-10-31 19:32:01 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`For instructions on building and installing Blender, please see the file named`
			`INSTALL.`
I made a little readme to get people started and modified the nan_definitions.mk to setup NANBLENDERHOME and everything is under that directory. also add empty dirs for lib and obj. Try it out and feel free to make improvements. mein@cs.umn.edu 2002-10-31 19:32:01 +00:00
Added links to external packages you may need to download. python, openal, nspr etc... Kent 2002-11-04 16:32:14 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`---------------------.Blanguages and the .blender directory---------------------`
Added links to external packages you may need to download. python, openal, nspr etc... Kent 2002-11-04 16:32:14 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`The .blender directory holds various data files for Blender.`
			`In the 2.28a release those are the .Blanguages file containing a list of`
			`translations, the translations themselves and a default ttf font.`
Added a link for mozilla downloads. Kent -- mein@cs.umn.edu 2002-11-12 15:56:33 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Blender checks for the presence of this directory in several locations:`
			`- the current directory`
			`- your home directory`
			`- On OSX, the blender bundle is also checked`
			`- On Windows, the installation dir is checked.`
Added a link for where to get glut Kent -- mein@cs.umn.edu 2002-12-20 09:52:45 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`If you get a 'File ".Blanguages" not found' warning, try to copy the .blender`
			`dir to one of these locations (your home directory being recommended).`
- Provide upstream urls for the i18n work (gettext, freetyp2 and FTGL) - Explain not all translations are done yet in the release - List the needed patch for FTGL to get uniformly coloured glyphs 2003-05-10 14:29:25 +00:00


- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`-------------------------------------Links--------------------------------------`
- Provide upstream urls for the i18n work (gettext, freetyp2 and FTGL) - Explain not all translations are done yet in the release - List the needed patch for FTGL to get uniformly coloured glyphs 2003-05-10 14:29:25 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Getting Involved:`
			`http://www.blender.org/docs/get_involved.html`
Added links to external packages you may need to download. python, openal, nspr etc... Kent 2002-11-04 16:32:14 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Community:`
			`http://www.blender3d.org/Community/`
Added some comments on FTGL Kent 2003-05-13 19:45:57 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Main blender development site:`
			`http://www.blender.org/`
Moved the stuff on autoconfig to doc/autoconfig.txt and added quite a bit more on the basics of it. (as well as put a link to it in the README) Kent -- mein@cs.umn.edu 2002-11-21 14:20:42 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`The Blender project homepage:`
			`http://projects.blender.org/projects/bf-blender/`
Ok were getting somewhere here ;) I'm not an expert at this but I think I'm getting the hang of it quite nicely. I added autoconf stuff for most of the intern dir. I move readme.txt to README and added the following section to it: ******************************************************************* ******************************************************************* We are in the process of moving things over to automake/autoconf The old makefiles are still in place and will work. If you want to get a working blender skip down to the next section and use this readme as a guide. If you want to play with the new autoconf environment you need to do the following, inside this dir: ./bootstrap mkdir ../newdir cd ../newdir ../blender/configure Take a look at INSTALL for options you can give to configure. About half of the intern directory is done so you won't get very far. If you want to work on fixing it you need to edit Makefile.am's and configure.ac after editing those files you need to run bootstrap again. TODO to finish up the intern dir Square away how ghost works. (i.e. would be nice if under windows you could choose X11 or normal windows libs, same with macos.. right now its a cludge and it doesn't do one explicitly probably involves changing the way configure.ac picks stuff) Get intern/python figured out. Add the following to configure.ac --with-openssl=dir --with-mozilla=dir (get it so nspr is autodetected here) --with-nspr=dir (incase in different dir) --with-jpeg=dir --with-png=dir --with-zlib=dir figure out why the heck the libtool that gets created is wrong on my system (mein@cs.umn.edu) :) Kent -- mein@cs.umn.edu 2002-11-15 06:57:59 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Documentation:`
			`http://www.blender.org/modules.php?op=modload&name=documentation&file=index`
Ok were getting somewhere here ;) I'm not an expert at this but I think I'm getting the hang of it quite nicely. I added autoconf stuff for most of the intern dir. I move readme.txt to README and added the following section to it: ******************************************************************* ******************************************************************* We are in the process of moving things over to automake/autoconf The old makefiles are still in place and will work. If you want to get a working blender skip down to the next section and use this readme as a guide. If you want to play with the new autoconf environment you need to do the following, inside this dir: ./bootstrap mkdir ../newdir cd ../newdir ../blender/configure Take a look at INSTALL for options you can give to configure. About half of the intern directory is done so you won't get very far. If you want to work on fixing it you need to edit Makefile.am's and configure.ac after editing those files you need to run bootstrap again. TODO to finish up the intern dir Square away how ghost works. (i.e. would be nice if under windows you could choose X11 or normal windows libs, same with macos.. right now its a cludge and it doesn't do one explicitly probably involves changing the way configure.ac picks stuff) Get intern/python figured out. Add the following to configure.ac --with-openssl=dir --with-mozilla=dir (get it so nspr is autodetected here) --with-nspr=dir (incase in different dir) --with-jpeg=dir --with-png=dir --with-zlib=dir figure out why the heck the libtool that gets created is wrong on my system (mein@cs.umn.edu) :) Kent -- mein@cs.umn.edu 2002-11-15 06:57:59 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Bug tracker:`
			`http://projects.blender.org/tracker/?atid=125&group_id=9&func=browse`
I added the following comments to the readme: --Notes on compiling mxTextTools To get the latest version to compile on my machine I had to edit mxSetup.py and remove /usr/include from INCLPATH for it to build properly. (after doing this you need to edit blender/source/Makefile and fix the pointer to it I'm still working on automating this) Kent -- mein@cs.umn.edu 2002-11-08 10:28:47 +00:00
- Split build/install info out from README into INSTALL - Add information on the .blender dir - Add some helpful links 2003-08-10 13:55:20 +00:00			`Feature request tracker:`
			`http://projects.blender.org/tracker/?atid=128&group_id=9&func=browse`