Comments (10)
OK.. that's a good FR, but would be a huge amount of work to restructure and manage our documentation in a database that could be used like that, and I'm not really sure if it's something that would be of interest to enough people to justify that (..?)
But it's an interesting idea - as we get further into the process of designing the way we'll handle soul library packages and their metadata, this is likely to become something that we'd consider.
Thanks!
from soul.
Hello Julian,
very big thanks in advance!
I am the blind programmer and help in commandline very accessible and if you create functions for analize signal this more useful for reading...
Thanks!
from soul.
Ah! I can see why something like that would help you navigate the docs then. Thanks for the FR!
from soul.
If you want, I can help you to quickly move the documentation to the console version, if you show an example of how it should be formatted.
from soul.
Thanks for the offer. But first we'd need to have a serious think about exactly what format we'd use to manage the data, what kinds of tools we'd need to write to present and search it. It's not a trivial task! What might be helpful would be if you could post a few quick examples so we could look at them and ponder on what a good strategy might be..
from soul.
O'k, i will write.
from soul.
Hello Julian,
For example in console:
<command_name>
[small example for command]
...
For "help(...)" argument in console, example:
soul help(float)
float
- fastest floating-point type that provides at least 32-bit precision
example:
float variable_name = 0.12345;
soul help(doc)
[instructions, functions, structures, variables...]
basic types: float, int, bool...
functions: init(), run()...
namespaces: soul...
...
soul help(soul::normaliseValue)
arguments: int i
return value: float
description: ...
Sorry, i don't know Juce very well and can't write finished code, unless in pure C.
from soul.
OK, thanks. We've been chatting about all the ins-and-outs involved in doing this. It's quite a chunk of work because we'd have to build some kind of database of this kind of language documentation, and also a system for annotating and parsing all the library code (which would probably mean writing our own parser like doxygen, for soul). Definitely all stuff we'd like to do, but probably will have to wait a while until we have more time/resources!
from soul.
Hello Julian,
o'k, thanks!
I have not found actual documentation for libraries on soul.dev site. Now I'm analyzing the code and write a list of functions with arguments and return values.
from soul.
FYI just to close-off this request, we have got a documentation generator now:
https://soul-lang.github.io/SOUL/docs/soul_library.html
We'll be updating it with more features, a search, etc as time goes on.
from soul.
Related Issues (20)
- License confusion HOT 1
- Add INSTALL file HOT 3
- SOUL Language Server HOT 3
- [LICENSE.md](https://github.com/soul-lang/SOUL/blob/master/LICENSE.md) should be changed to text of ISC license HOT 1
- Proposal: graph fan-in using multiplication HOT 1
- link error in code generated by SOUL 1.0.82 HOT 2
- WASM example HOT 1
- soul::DFT::forward output is half as long as it should be HOT 2
- Windows: Couldn't find or load SOUL_PatchLoader.dll HOT 1
- Is there a way to contribute to SOUL's development? HOT 1
- Illegal indirection (C2100 ) compiler error in `3rdParty/choc/audio/choc_SampleBuffers.h`
- Impossible to resolve external variable
- ASIO output on Windows using the CLI
- What is the future of SOUL? HOT 13
- Integer `events` seems to be messed up
- Documentation about faceplate HOT 1
- It needs libraries, modules, preprocessor, something HOT 5
- Compile error with JUCE 6.1.5 HOT 1
- simper_eq bugs
- soul可以查看隐身的人吗?
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from soul.