search

facebook / buck

A fast build system that encourages the creation of small, reusable modules over a variety of platforms and languages.
https://buck.build
Apache License 2.0
8.56k stars 1.16k forks source link

Many Undocumented Build Rules: http://facebook.github.io/buck/ #277

Closed minid33 closed 9 years ago

minid33 commented 9 years ago

When I browse the code for this project I can see that there are many undocumented build rules. For example Buck seems to be capable of building an iOS app (and do many more undocumented rules) but this is not documented here : http://facebook.github.io/buck/

Are there plans to update this page so that we can use Buck without having to read the source to identify and implement the latest capabilities of Buck?

bolinfest commented 9 years ago

It's generally the case that undocumented rules aren't fully baked yet, including the iOS and OCaml ones. We will certainly document them once they are ready to use! For now, caveat emptor.

On Wednesday, March 25, 2015, Jaimie Fryer notifications@github.com wrote:

When I browse the code for this project I can see that there are many undocumented build rules. For example Buck seems to be capable of building an iOS app (and do many more undocumented rules) but this is not documented here : http://facebook.github.io/buck/

Are there plans to update this page so that we can use Buck without having to read the source to identify and implement the latest capabilities of Buck?

— Reply to this email directly or view it on GitHub https://github.com/facebook/buck/issues/277.

sdwilsh commented 9 years ago

Yup, it's intentional that those aren't documented. You can use them, and file issues about them, but we don't want to encourage their use yet by documenting them.

MartinRogalla commented 9 years ago

Thank you so much for your contributions. How stable is Buck currently for iOS? Do you have an ETA for when it will be fully supported and documented?

sdwilsh commented 9 years ago

We're using it internally for various parts at Facebook, but there's a long-tail of issues. We're hoping to have something out there soon that folks can start to provide feedback on.