home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #20 / NN_1992_20.iso / spool / comp / os / linux / 10013 < prev    next >
Encoding:
Text File  |  1992-09-08  |  9.2 KB  |  253 lines
  1. Newsgroups: comp.os.linux
  2. Path: sparky!uunet!cs.utexas.edu!sdd.hp.com!ux1.cso.uiuc.edu!rs6000.cmp.ilstu.edu!jliddle
  3. From: jliddle@rs6000.cmp.ilstu.edu (Jean Liddle)
  4. Subject: Patch Repository Now Open: rs6000.cmp.ilstu.edu
  5. Message-ID: <1992Sep06.191543.22018@rs6000.cmp.ilstu.edu>
  6. Date: Sun, 06 Sep 1992 19:15:43 GMT
  7. References: <k=pnyqq.genie@netcom.com> <bjl.715800296@freyr>
  8. Organization: Illinois State University
  9. Lines: 242
  10.  
  11. Greetings fellow Linuxers!
  12.  
  13. At long last, after 2 weeks of testing, the Patch Repository is
  14. open for business :).
  15.  
  16. rs6000.cmp.ilstu.edu [138.87.1.2]: pub/linux
  17.  
  18. pub/linux/Incoming is rwxt for everyone, so contributions can be put
  19. there.
  20.  
  21. What follows are the README and README.template files which
  22. can be found under pub/linux.  When uploading patches, please use
  23. the README.template file and edit it according to the requirements
  24. of the patch you have made.  It is hoped that a Patch Repository will
  25. encourage people to upload diffs (unified diffs made with diff -ur
  26. are preferred as they are usually much smaller than cdiffs, although
  27. no patch will be turned away! :)) to programs they have ported to
  28. linux even when they may be reluctant to upload entire binaries or
  29. patched sources.  Thus, hopefully an even wider variety of software
  30. will be easilly installable by both casual and expert linux users.
  31.  
  32. Also, if you find programs on the net which compile strait out of the
  33. box, please feel free to upload a note on where the file can be gotten
  34. and what special steps, compile options, etc. you used to get it to
  35. compile successfully.  If you would like to use the README.template for
  36. this purpose as well, so much the better.  The goal is to make compiling
  37. and installing diverse software as easy as possible for users, assuming
  38. they have a working gcc installed.
  39.  
  40. Suggestions, etc. can be sent to jliddle@ilstu.edu.
  41.  
  42. If you find a patch outdated or have an improvement, please feel free to
  43. upload it as well.  Uploads which are accompanied by a note to me at the
  44. e-mail address above will probably be noticed sooner than those simply
  45. placed in incoming with no notice.
  46.  
  47. BTW - I have made incoming xrw by everyone (with sticky bit on:)), so
  48. contributers will probably want to make sure read permissions are set
  49. for group and other so that others can download new patches even before
  50. I get around to moving them to the proper directories.
  51.  
  52. [ start README ]
  53.  
  54. this site is intended as a collection and distribution center for
  55. any and all patches which are to be applied to any and all software
  56. so that it can be compiled and run under LINUX.  It is hoped that,
  57. by making patches available to users which can be applied to
  58. packages commonly available on the internet, more users will have
  59. access to a greater variety of software, and less duplication of
  60. effort will occur.
  61.  
  62. HOW TO FIND THE PATCH YOU NEED
  63.  
  64. The "root" directory of the linux stuff is in /u/ftp/pub/linux.
  65. Beneath this, the directory tree is organized as follows:
  66.  
  67. pub/linux/-+-Incoming/ (Writable by everyone, this is where you
  68.            |            put your contributions.  Don't forget
  69.            |            to email me and let me know its there!)
  70.            |
  71.            +-Utilities/ (patches to standard gnu/linux utilities
  72.            |             such as gmake, flex, bison, etc. with 
  73.            |             pointers to the original code from the FSF
  74.            |             or other sites)
  75.            |
  76.            +-Applications/ (patches to unix apps to run under linux)
  77.            |
  78.            +-System/ (this would be the only directory with actual
  79.            |          source code in addition to patches, for linux
  80.            |          kernel sources and patches, and system
  81.            |          software such as filesystems, etc.)
  82.            |
  83.            +-X11R5/-+-mit  (X11 stuff.  The tree would resemble
  84.                     |       the mit R5untarred tree structure at
  85.                     |       export, with patches for clients, libs,
  86.                     |       etc., in the appropriate directories)
  87.                     +-contrib (third party x windows
  88.                                contributions, such as xasteroids,
  89.                                etc. :))
  90.  
  91. Filenames for Incoming stuff will be whatever the person submitting
  92. the patch feels like calling it.  Once I move it to the appropriate
  93. place in the directory tree, I will rename it so that the filename
  94. describes what version of the program the patch applies to, what
  95. version of linux it was compiled under, and what version of GCC was
  96. used.  So, for example, a patch for progname Version 2.15, compiled
  97. under linux 0.97.1 with gcc 2.2.2 would be called:
  98.  
  99. progname215.097-1.222.tar.Z
  100.  
  101. WHAT IS IN THE .tar.Z FILE
  102.  
  103. progname.p01 - The patch file, which you will apply to the
  104.                source.
  105. README.progname - Instructions on where to find the source
  106.                to which the patch will be applied, how to
  107.                apply the patch, and what, if any, special
  108.                steps must be taken to compile the patched 
  109.                source.
  110.  
  111. HOW TO APPLY PATCHES
  112.  
  113. Assuming you have untarred the source.tar.Z file into the
  114. directory /usr/src/source, applying the patch is very simple.
  115. $ cd /usr/src
  116. $ patch -p0 < patchfile
  117.  
  118. where "patchfile" is the complete path to "source.pNN", the 
  119. patch which you downloaded.
  120.  
  121. Detailed instructions on how to patch and compile the source
  122. are included in the README.progname file, included in the
  123. patch.tar file you downloaded.  Some applications will require
  124. additional configuration, which is generally specified in the
  125. README, install.doc, or similar file contained in the source.tar.Z
  126. file you downloaded.
  127.  
  128. HOW TO SUBMIT PATCHES
  129.  
  130. 1. Just put the progname.p01 and README.progname files
  131.    in the /u/ftp/pub/linux/Incoming directory, either as
  132.    seperate files or already archived into a .tar file
  133.    and ...
  134. 2. send mail to jliddle@ilstu.edu, so I know it's there.
  135.  
  136.    I have made the Incoming directory readable and writable
  137.    by everyone, so people can download patches even before
  138.    I get to them `a la sunsite.unc.edu.  Nevertheless, I will
  139.    try to move patches to the appropriate directory as quickly
  140.    as possible.
  141.  
  142. HOW TO MAKE PATCHES FOR DISTRIBUTION
  143.  
  144. In order to make life as painless as possible for those
  145. downloading and applying patches, patches submitted should have
  146. the following properties:
  147.  
  148. o Assuming the source code is in /usr/src/source, the user
  149.   should be able to apply the patch from /usr/src and have all 
  150.   of the necessary changes made throughout the entire directory
  151.   tree beneath /usr/src/source
  152.  
  153. o A README file, based on the README.template in
  154.   /u/ftp/pub/linux should be included.  This will help the user
  155.   find the same source files from which you made that patch, and
  156.   guide him or her through any special steps necessary to apply
  157.   the patch and compile the sources.  A good example is the
  158.   README.xzap-1.0 file included with the xzap patches in X11R5/contrib/clients.
  159.   It points out several things the user must do to compile the
  160.   program successfully before and after applying the patch
  161.   (e.g. running xmkmf before applying the patch so that patch
  162.   can also update the resulting Makefile)
  163.  
  164. And, since space on our site is limited, Please use
  165.  
  166. diff -ur
  167.  
  168. to make patches, instead of diff -crw.  The resulting diffs are usually
  169. much smaller, and patch has no trouble with them.  -- Thanks!
  170.  
  171. -------
  172. The following is how I make patches - you might want to do
  173. something similar.
  174.  
  175. Assume the source code I have hacked so that it compiles and
  176. runs successfully under linux is in /usr/src/source.
  177.  
  178. Assume my current working directory is /usr/src/source
  179.  
  180. 1. Clean up the mess I've made compiling stuff
  181.    $ make clean
  182.    (or, rm *.o core, etc. if make clean doesn't work)
  183.  
  184. 2. change directory to parent
  185.    $ cd ..
  186.    (`pwd` -> /usr/src)
  187.  
  188. 3. move /usr/src/source to /usr/src/source.new
  189.    $ mv source source.new
  190.  
  191. 4. untar the original sources again
  192.    $ tar xvf /downloadpath/source.tar
  193.    (which creates /usr/src/source and its respective subdirs)
  194.  
  195. 5. make a unified diff against the original sources
  196.    $ diff -ur source source.new > source.p01
  197.  
  198. 6. copy the readme template to README.source, type in the
  199.    needed info, and put the two into a .tar file for uploading.
  200.    $ cp README.template README.source
  201.    $ joe README.source
  202.    $ tar clvf source10.097-1.222.tar source.p01 README.source
  203.  
  204. If you are using the minix filesystem and cannot make the
  205. filename descriptive, don't worry about it.  As long as the
  206. pertinant info (program version, linux version/patchlevel, and
  207. gcc version) are in the README.source file, I can rename the 
  208. file accordingly.
  209.  
  210. Please send any suggestions, ideas, and constructive criticism to
  211. jliddle@ilstu.edu.
  212. [ end README ]
  213.  
  214. [ start README.template ]
  215. Program: 
  216. Description:
  217. Requirements:
  218.    -
  219.    - Linux ver.      * 
  220. * May work under earlier version, but untested.
  221. ----
  222. Source: 
  223. File Size: 
  224. Available From: 
  225. In:
  226.  
  227. Or use ARCHIE to locate file at other ftp sites 
  228. ----
  229. Patch submitted: 
  230. By: 
  231. Compiled With: 
  232. Under: 
  233. ====
  234. How to compile 
  235. ----
  236. 0. (untar the source)
  237.    $ tar xvf 
  238. 1.
  239. 2. (apply the patch)
  240.    $ patch -p0 < 
  241. 3. $ make
  242. ----
  243. Files
  244. ----
  245. README.  - This File
  246.   - Patch to apply
  247. [ end README.template ]
  248.  
  249. -- 
  250. Jean Liddle                                 | == Bill Clinton for President ==
  251. Computer Science, Illinois State University | 
  252. e-mail:  jliddle@ilstu.edu                  | - Carol Mosley Braun for Senat -
  253.