Just another one: perhaps we should think and standarize the HELP (HTML-Help) directories, so that we distribute the HTM with the packages itself, as opposed to submit them to the HTML-Help maintainer, and hope that both programs (mine and HTML-Help) will be distributed together with the sync-ed versions.
Aitor 2006/8/28, Aitor Santamaría <[EMAIL PROTECTED]>: > Two small notes: > (1) The HELP file (for FASTHELP) is probably NOT required in the > source package either > (2) There are docs that are very specific to sources (e.g. how to > build and such), that I myself usually don't pack under DOC, but under > SRC\DOC, so that they are only installed with sources (I don't know if > I'm doing it well). > > Aitor > > PS: Jim, I don't know if you read my message from private mail: I was > just trying to ask you if you could "allow" or "invite" me to write to > you private messages from this account of mine (gmail). I say this as > I know your university seemed to have an ellaborate way of granting > access to you ;-) > > > 2006/8/28, Jim Hall <[EMAIL PROTECTED]>: > > I think you are referring to this mini-HOWTO: > > http://fd-doc.sourceforge.net/wiki/index.php?n=FdDocEn.Distribution > > > > > > Yes, I agree that the source package should contain everything short of > > the generated binaries. If there are dupe files, let them be > > overwritten. This mini-HOWTO needs to be updated to say that. > > > > > > -jh > > > > > > > > > > Eric Auer wrote: > > > Hi all, > > > > > > Blair pointed me to the fact that "source" packages > > > are not supposed to contain docs, according to our > > > specs. I object that recommendation. In my opinion, > > > "source" packages should contain everything outside > > > the bin directory, and "binary" packages should > > > contain everything outside the source directory. > > > > > > My reason for this recommendation is that end users > > > should have all documentation and that all documen- > > > tation in fact IS part of the source code. When we > > > work on updating a program, it has to be sufficient > > > to download ONLY the source package to create a new > > > version of the full binary package. > > > > > > One might say that this wastes space in situations > > > where you put both source and binary package zips > > > in one directory. Well. Shit happens. Or if that is > > > not acceptable, one could put "MINIMAL SOURCE" zip > > > packages in that directory, containing ONLY the > > > source directory contents. Along with a readme which > > > tells that the source zips in that directory can only > > > be used in combination with the binary zips. > > > > > > Source packages which are available via http should > > > contain the full docs. This avoids two problems: > > > > > > - people would otherwise have to download the old > > > exe even if they only wanted the docs, for example > > > for creating derived versions of the sources > > > > > > - programmers would otherwise easily forget to update > > > the docs or, even worse, the NLS files when they > > > modify the source code > > > > > > An alternative solution for all the hassles might be > > > to have the docs in a third zip. Then you would have > > > to download 2 of 3 zips for development and 2 of 3 > > > zips for using the program. And all 3 zips would have > > > minimal size. If anybody cares for size of source > > > packages. > > > > > > Still I would really prefer to have all docs in the > > > source zips! After all, people usually download only > > > the sources of SELECTED packages. And the open source > > > idea tells me that the sources are the origins of the > > > world, so it should not be necessary to download the > > > binary package to understand the sources. > > > > > > Eric > > > > > > > > > > > -- > > This email message has been encrypted using the ROT-26 cipher. > > > > > > ------------------------------------------------------------------------- > > Using Tomcat but need to do more? Need to support web services, security? > > Get stuff done quickly with pre-integrated technology to make your job > > easier > > Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo > > http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 > > _______________________________________________ > > Freedos-devel mailing list > > Freedos-devel@lists.sourceforge.net > > https://lists.sourceforge.net/lists/listinfo/freedos-devel > > > ------------------------------------------------------------------------- Using Tomcat but need to do more? Need to support web services, security? Get stuff done quickly with pre-integrated technology to make your job easier Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642 _______________________________________________ Freedos-devel mailing list Freedos-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/freedos-devel
