How to make/maintain a port

Ancient

Ancient

I've learning that some of the soft here is discontinued. I want to know how to maintain, making it. And what is "porting"? It is something alike about to bring a program here, or I am wrong? Of course I'm reading the handbook. In fact, I found that there is a "porter handbook". I'm reading the chapter 2, but it says few things. Which is the chapter or handbook that describes the process? Perhaps I could bring some things...
 
Do you think it will be less dangerous if I develop one in a jail? Or it will be more difficult/complex?
 
I found the documentation on porting extremely intimidating.
I've noticed with the FreeBSD documentation in general that some chapters are aimed at newbies (like the part that explains the difference between a compiler and an interpreter for Heaven's sake) and some parts are highly technical and complex (like the porter's handbook).
And it all seems to be mixed in together.
 
AlexanderProphet said:
I found the documentation on porting extremely intimidating.
[...] and some parts are highly technical and complex (like the porter's handbook).
Click to expand...

Indeed. I had occasion to check out the Porters' Handbook a couple of nights ago. The most obvious issue (to me) was that it had been written by someone/s intimately familiar with the process and as a result left some things to the imagination of those not intimately familiar with the process.

An example - the full one page section:

"3.3. Creating the Checksum File

Just type make makesum. The ports framework will automatically generate distinfo. Do not
try to generate the file manually."

I eventually figured out by trial and error that you first needed to setup all the files in a "dummy" /usr/ports/[category]/directory for that command to work. Something which is obvious to someone intimately familiar with the process, but not to someone for whom this is a first attempt.

So I disagree with: "Such things are that way out of necessity, not convenience". Obtuseness is definitely not out of necessity.

Finally - yes, I will submit a patch or indeed patches once I have successfully completed the entire process which has been shelved for the moment while I deal with other kernel module patches.
 
I'm glad it's not just me. I didn't even get as far as trying to make my own port. (I'm writing a malloc profiler). I just read a few pages about porting and then... Well I don't drink alcohol but if I did then I would have needed a stiff drink.
Has anyone written a tutorial?
 
Pyret that is so true. Didn't Einstein say something like "If you can't explain it to a six year old, you don't understand it yourself."
I'm not attacking the volunteers who write all the this stuff - I think it's normal for technical documentation to be inscrutable. But "normal" isn't the same as "good" and communicating ideas is so important - just as important as having the ideas in the first place.
 
pyret What I'm saying is that when one communicates highly technical elements, one must speak in terms that are sometimes highly technical and not meant for students or beginners. These terms are often not difficult for the professional to understand and they must be written in a way for them to properly get the job done without the nuances a student may need. The Handbook may be at different levels of writing--on a technical level--that one may find difficult to understand but you might ask, "What's the problem?".
 
AlexanderProphet said:
I found the documentation on porting extremely intimidating.
I've noticed with the FreeBSD documentation in general that some chapters are aimed at newbies (like the part that explains the difference between a compiler and an interpreter for Heaven's sake) and some parts are highly technical and complex (like the porter's handbook).
And it all seems to be mixed in together.
Click to expand...

I can agree!
 
I think that the documentation is very good. For the first step consider to port something which has almost no dependencies. I have done my first steps with setserial just to see how things work. I am very sure that this is doable for anybody and good as an exercise. My main issues are lack of experience with things as github and similar. But this is a different story and more severe ;-).
 
So if the documentation on packaging has to be highly technical, that raises a question: what should I read first? If I wanted to study calculus I'd read algebra. What do I need to read to learn FreeBSD packaging?
 
I suggest you start by updating an existing and unmaintained port. That way you already have a base to work with and you can get familiar with the process.
 
I have been looking for a tutorial, video, youtube, blog etc and etc and etc with the steps of how to create a port or how it is updated and I have not found it anywhere .. I want to learn and it is true that the technical language It is necessary sometimes because it is as it should be said so that things work well but I admit that I also do not understand the official manual for ports .. it would be good if someone with experience can make a guide or something easy to understand for those of us who are newbbies and we want to contribute with the ports. A link takes me to another link just to find out how it was to find outdated packages and I'm still confused .. Maybe there are no more maintainers because those who want to try do not find a less difficult way to learn how to do it, sure that when we have a base of the process we could do the rest by ourselves
 
You must log in or register to reply here.
Back
Top