Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 2 years ago.
Improve this question
I've been working on some ruby libraries with C extensions now. And I want to give users access to the irb#help method, e.g:
> help("Array#empty?")
# Prints documentation for the method.
I've been using the same way to name functions as ruby core, and the same documentation pattern. However, irb always tell me that there is Nothing known about FastPolyline.decode.
Here's my method:
/*
* call-seq:
* FastPolylines.decode([[1,1]]) -> String
*
* Decodes a polyline.
*/
static VALUE
decode(int argc, VALUE *argv, VALUE self) {
I've tried naming the method various ways, such as rb_FastPolylines__decode, rb_fast_polylines_decode, rb_decode. None worked..
I've been looking on internet, but couldn't find any convincing resource on How to document a ruby C extension. Do you have any inputs on this ?
Related
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 4 years ago.
Improve this question
On the YARD readme, there is mention of raw data generated by YARD:
YARD also outputs documented objects as raw data (the dumped
Namespace) which can be reloaded to do generation at a later date, or
even auditing on code. This means that any developer can use the raw
data to perform output generation for any custom format, such as YAML,
for instance.
What are examples/blogs/tutorials of using the raw data and translating it to other formats? For example, I am interested in transforming parts of the raw data into YAML.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 4 years ago.
Improve this question
I'm using this Songkick wrapper and it works for getting grabbing events by artist like so:
sk.events(:artist_name => "Balimurphy")
But I'm having trouble grabbing events by location. Songkick is expecting the query to look like this
location=geo:lat,lng
I'm having trouble finding the right syntax to pass lng=-73.5833, lat=45.5. Here are some variations I've tried:
sk.events(:location => :geo=>{:lng=>"-73.5833", :lat=>"45.5"})
sk.events(:location => {:geo=>lng=-73.5833, lat=45.5})
sk.events(:location => "geo=-73.5833,45.5")
Any ideas?
Where can I find documentation that might cover this?
I've been looking through the following 3 sources:
https://github.com/jrmehle/songkickr
http://rubydoc.info/gems/songkickr/0.1.0/frames
http://www.songkick.com/developer/event-search
and I think you need to change your last attempt to
sk.events(:location => "geo:-73.5833,45.5") # geo:
One example on the songkick page has location=ip:94.228.36.39. This makes me think that it for location, it wants location=type:data.
I assume that the hash you pass gets turned into key=value (just looking at the songkick page and your working example).
Therefore, you would want your value to be "geo:-73.5833,45.5" and your key to be "location".
I hope this works for you!
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I've seen magic variables like this used in Ruby. $_ $' $0
Is there a complete reference for what all of them mean and how they are set?
Their name is global variables. There are several different references.
You can get a full list by calling the method Kernel#global_variables
puts global_variables
Ruby also includes a file called "English.rb" in the standard library which provides an in-depth explanation of several global variables.
Also, there's (an archived version of) "Cryptic Ruby Global Variables and Their Meanings".
Finally, the Ruby Programming wikibook has a "Predefined Variables" reference.
They are called "global variables" (complete list at the bottom of the page): http://www.rubyist.net/~slagell/ruby/globalvars.html
The Ruby documentation used to be very class orientated. In recent versions of Ruby however there are rdoc files about literals, precedence, syntax, globals and much more.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 4 years ago.
Improve this question
I was wondering if there is a tool (automator script or a third party) to generate code for simple scenarios like add another property. I don't like going to two or three places and write the same thing over and over again. instead I want to say "I want a new property of type int with name X" and it generates the lines in .h and .m files for me in one go.
I haven't actually used either, but xobjc is free (though requires you to do some code annotations) and Accessorizer looks interesting if somewhat complicated to setup.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I want to format my existing comments as 'RDoc comments' so they can be viewed using ri.
What are some recommended resources for starting out using RDoc?
A few things that have bitten me:
:main: -- RDoc uses only the last one evaluated; best to make sure there's only one in your project and you don't also use the --main command-line argument.
same as previous, but for :title:
:section: doesn't work very well
RDoc uses SimpleMarkup so it's fairly simple to create lists, etc. using *, - or a number. It also treats lines that are indented at the same column number as part of the same paragraph until there is an empty line which signifies a new paragraph. Do you have a few examples of comments you want RDoc'ed so we could show you how to do them and then you could extrapolate that for the rest of your comments?