Error since v0.9.21: constant mapping (YARD::Parser::UndocumentableError)

49 views
Skip to first unread message

Chris Lasell

unread,
Jan 13, 2020, 4:12:24 PM1/13/20
to yar...@googlegroups.com
Hello Yard Folks!

As of release v0.9.21, my project `ruby-jss` fails to generate the html docs, both locally and at rubydoc.info: https://www.rubydoc.info/gems/ruby-jss/


The full output of a local `yard --verbose --debug -o /tmp/fixyard/` for version 0.9.24 is pasted below, with a backtrace at the bottom. It seems to match the error you see on rubydoc.info.


I know I always have lots of cleanup to do in my Yard formatting, but its always successfully created the html in the past.

Just now I removed and re-installed older versions of yard, and ran the same command for each until I found that v0.9.20 works without the error. 0.9.21-23 all failed in a similar way to 24.

I’d be happy to fix whatever’s causing this in my code, but the debug output doesn’t really help me locate the source of the problem. I could methodically work through all the warnings, that’ll take a time, and I won’t be able to get to that task for a while, so any pointers are welcome.

Let me know if I can provide more info.

Cheers & Thanks for providing such a useful tool to the Ruby community!

-Chris

--
Chris Lasell
Apple Peeler
Pixar Animation Studios


------------ output of `yard --verbose --debug -o /tmp/fixyard/` in v0.9.24

[debug]: Parsing ["{lib,app}/**/*.rb", "ext/**/*.{c,cc,cxx,cpp,rb}"] with `ruby` parser
[debug]: Parsing lib/jss.rb
[debug]: Parsing lib/jamf.rb
[debug]: Parsing lib/jpapi.rb
[debug]: Parsing lib/jss-api.rb
[debug]: Parsing lib/ruby-jss.rb
[debug]: Parsing lib/jss/client.rb
[debug]: Parsing lib/jss/server.rb
[debug]: Parsing lib/jamf/client.rb
[debug]: Parsing lib/jss/utility.rb
[warn]: @param tag has unknown parameter name: processor
in file `lib/jss/utility.rb' near line 129
[warn]: Unknown tag @seealso in file `lib/jss/utility.rb` near line 280
[warn]: @param tag has unknown parameter name: Set
in file `lib/jss/utility.rb' near line 505
[debug]: Parsing lib/jss/version.rb
[debug]: Parsing lib/jamf/utility.rb
[warn]: @param tag has unknown parameter name: processor
in file `lib/jamf/utility.rb' near line 128
[warn]: Unknown tag @seealso in file `lib/jamf/utility.rb` near line 274
[warn]: @param tag has unknown parameter name: Set
in file `lib/jamf/utility.rb' near line 411
[debug]: Parsing lib/jamf/version.rb
[debug]: Parsing lib/jss/composer.rb
[warn]: Unknown tag @options in file `lib/jss/composer.rb` near line 95
[debug]: Parsing lib/jss/validate.rb
[debug]: Parsing lib/jamf/composer.rb
[warn]: Unknown tag @options in file `lib/jamf/composer.rb` near line 95
[debug]: Parsing lib/jamf/validate.rb
[debug]: Parsing lib/jss/api_object.rb
[warn]: Unknown tag @init_data. in file `lib/jss.rb` near line 152
[warn]: @param tag has unknown parameter name: identfier
in file `lib/jss/api_object.rb' near line 584
[warn]: @param tag has unknown parameter name: identfier
in file `lib/jss/api_object.rb' near line 636
[warn]: @param tag has unknown parameter name: identfier
in file `lib/jss/api_object.rb' near line 668
[warn]: @param tag has unknown parameter name: name
in file `lib/jss/api_object.rb' near line 978
[warn]: @param tag has unknown parameter name: api
in file `lib/jss/api_object.rb' near line 978
[warn]: Unknown tag @seealso in file `lib/jss/api_object.rb` near line 1224
[warn]: Unknown tag @subclasses.each
[debug]: Parsing lib/jss/exceptions.rb
[debug]: Parsing lib/jamf/exceptions.rb
[debug]: Parsing lib/jss/compatibility.rb
[debug]: Parsing lib/jss/configuration.rb
[debug]: Parsing lib/jss/db_connection.rb
[debug]: Parsing lib/jamf/compatibility.rb
[debug]: Parsing lib/jamf/configuration.rb
[debug]: Parsing lib/jss/api_connection.rb
[warn]: @param tag has unknown parameter name: &block
in file `lib/jss/api_connection.rb' near line 1262
[warn]: @param tag has unknown parameter name:
in file `lib/jss/api_connection.rb' near line 1289
[debug]: Parsing lib/jss/api_object/mdm.rb
[debug]: Parsing lib/jss/xml_workaround.rb
[debug]: Parsing lib/jamf/api/connection.rb
[warn]: @param tag has unknown parameter name: host:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: port:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: user:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: pw:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: token:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: open_timeout:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: timeout:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: ssl_version:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: verify_cert:
in file `lib/jamf/api/connection.rb' near line 267
[warn]: @param tag has unknown parameter name: params
in file `lib/jamf/api/connection.rb' near line 534
[warn]: @param tag has unknown parameter name: params
in file `lib/jamf/api/connection.rb' near line 703
[warn]: Unknown tag @keep_alive_thread in file `lib/jamf/api/connection.rb` near line 766
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/connection.rb' near line 792
[debug]: Parsing lib/jss/api_object/site.rb
[debug]: Parsing lib/jss/api_object/user.rb
[debug]: Parsing lib/jss/ruby_extensions.rb
[debug]: Parsing lib/jamf/ruby_extensions.rb
[debug]: Parsing lib/jss/api_object/ebook.rb
[debug]: Parsing lib/jss/api_object/group.rb
[warn]: @param tag has unknown parameter name: m
in file `lib/jss/api_object/group.rb' near line 366
[warn]: @param tag has unknown parameter name: m
in file `lib/jss/api_object/group.rb' near line 378
[warn]: @param tag has unknown parameter name: api
in file `lib/jss/api_object/group.rb' near line 412
[debug]: Parsing lib/jss/api_object/policy.rb
[warn]: @param tag has unknown parameter name: reboot_message
in file `lib/jss/api_object/policy.rb' near line 910
[warn]: @param tag has unknown parameter name: position
in file `lib/jss/api_object/policy.rb' near line 1159
[warn]: @param tag has unknown parameter name: action
in file `lib/jss/api_object/policy.rb' near line 1159
[warn]: @param tag has unknown parameter name: feu
in file `lib/jss/api_object/policy.rb' near line 1159
[warn]: @param tag has unknown parameter name: fut
in file `lib/jss/api_object/policy.rb' near line 1159
[warn]: @param tag has unknown parameter name: update_autorun
in file `lib/jss/api_object/policy.rb' near line 1159
[warn]: @param tag has unknown parameter name: identfier
in file `lib/jss/api_object/policy.rb' near line 1187
[warn]: @param tag has unknown parameter name: identfier
in file `lib/jss/api_object/policy.rb' near line 1277
[debug]: Parsing lib/jss/api_object/script.rb
[debug]: Parsing lib/jss/api_object/account.rb
[debug]: Parsing lib/jss/api_object/ibeacon.rb
[debug]: Parsing lib/jss/api_object/package.rb
[warn]: @param tag has unknown parameter name: @see
in file `lib/jss/api_object/package.rb' near line 661
[debug]: Parsing lib/jss/api_object/sitable.rb
[debug]: Parsing lib/jss/api_object/vppable.rb
[debug]: Parsing lib/jss/api_object/webhook.rb
[debug]: Parsing lib/jss/client/jamf_binary.rb
[debug]: Parsing lib/jss/client/jamf_helper.rb
[debug]: Parsing lib/jamf/client/jamf_binary.rb
[debug]: Parsing lib/jamf/client/jamf_helper.rb
[debug]: Parsing lib/jss/api_object/building.rb
[debug]: Parsing lib/jss/api_object/category.rb
[debug]: Parsing lib/jss/api_object/computer.rb
[warn]: Unknown tag @hardware in file `lib/jss/api_object/computer.rb` near line 858
[debug]: Parsing lib/jss/api_object/scopable.rb
[debug]: Parsing lib/jamf/api/mixins/abstract.rb
[debug]: Parsing lib/jamf/api/mixins/lockable.rb
[debug]: Parsing lib/jss/api_object/creatable.rb
[warn]: @param tag has unknown parameter name: api
in file `lib/jss/api_object/creatable.rb' near line 74
[warn]: @param tag has unknown parameter name: name
in file `lib/jss/api_object/creatable.rb' near line 101
[debug]: Parsing lib/jss/api_object/locatable.rb
[debug]: Parsing lib/jss/api_object/matchable.rb
[debug]: Parsing lib/jss/api_object/updatable.rb
[warn]: Unknown tag @see_also in file `lib/jss/api_object/updatable.rb` near line 54
[debug]: Parsing lib/jss/ruby_extensions/hash.rb
[debug]: Parsing lib/jss/ruby_extensions/time.rb
[debug]: Parsing lib/jamf/api/connection/token.rb
[debug]: Parsing lib/jamf/api/mixins/immutable.rb
[debug]: Parsing lib/jamf/api/mixins/locatable.rb
[debug]: Parsing lib/jamf/api/mixins/referable.rb
[debug]: Parsing lib/jamf/ruby_extensions/hash.rb
[debug]: Parsing lib/jss/api_object/department.rb
[debug]: Parsing lib/jss/api_object/extendable.rb
[debug]: Parsing lib/jss/api_object/peripheral.rb
[debug]: Parsing lib/jss/api_object/uploadable.rb
[debug]: Parsing lib/jss/ruby_extensions/array.rb
[debug]: Parsing lib/jamf/api/mixins/change_log.rb
[debug]: Parsing lib/jamf/api/mixins/extendable.rb
[debug]: Parsing lib/jamf/api/mixins/searchable.rb
[debug]: Parsing lib/jamf/ruby_extensions/array.rb
[debug]: Parsing lib/jss/api_object/criteriable.rb
[debug]: Parsing lib/jss/api_object/ldap_server.rb
[warn]: @param tag has unknown parameter name: user
in file `lib/jss/api_object/ldap_server.rb' near line 140
[warn]: @param tag has unknown parameter name: server
in file `lib/jss/api_object/ldap_server.rb' near line 159
[debug]: Parsing lib/jss/api_object/patch_title.rb
[debug]: Parsing lib/jss/api_object/purchasable.rb
[debug]: Parsing lib/jss/ruby_extensions/ipaddr.rb
[debug]: Parsing lib/jss/ruby_extensions/object.rb
[debug]: Parsing lib/jss/ruby_extensions/string.rb
[debug]: Parsing lib/jamf/api/mixins/uncreatable.rb
[debug]: Parsing lib/jamf/api/mixins/undeletable.rb
[debug]: Parsing lib/jamf/ruby_extensions/ipaddr.rb
[debug]: Parsing lib/jamf/ruby_extensions/object.rb
[debug]: Parsing lib/jamf/ruby_extensions/string.rb
[debug]: Parsing lib/jss/api_object/patch_policy.rb
[warn]: @param tag has unknown parameter name: new_tgt_vers
in file `lib/jss/api_object/patch_policy.rb' near line 287
[warn]: @param tag has unknown parameter name: new_val
in file `lib/jss/api_object/patch_policy.rb' near line 313
[warn]: @param tag has unknown parameter name: new_val
in file `lib/jss/api_object/patch_policy.rb' near line 320
[warn]: @param tag has unknown parameter name: days
in file `lib/jss/api_object/patch_policy.rb' near line 328
[warn]: @param tag has unknown parameter name: new_period
in file `lib/jss/api_object/patch_policy.rb' near line 334
[warn]: @param tag has unknown parameter name: subj
in file `lib/jss/api_object/patch_policy.rb' near line 341
[warn]: @param tag has unknown parameter name: subj
in file `lib/jss/api_object/patch_policy.rb' near line 348
[warn]: @param tag has unknown parameter name: new_title
in file `lib/jss/api_object/patch_policy.rb' near line 558
[debug]: Parsing lib/jss/api_object/patch_source.rb
[warn]: @param tag has unknown parameter name: newname
in file `lib/jss/api_object/patch_source.rb' near line 288
[warn]: @param tag has unknown parameter name: new_port
in file `lib/jss/api_object/patch_source.rb' near line 295
[debug]: Parsing lib/jss/api_object/categorizable.rb
[debug]: Parsing lib/jss/api_object/mobile_device.rb
[debug]: Parsing lib/jss/api_object/self_servable.rb
[warn]: @param tag has unknown parameter name: new_val
in file `lib/jss/api_object/self_servable.rb' near line 574
[debug]: Parsing lib/jss/client/management_action.rb
[debug]: Parsing lib/jss/ruby_extensions/filetest.rb
[debug]: Parsing lib/jss/ruby_extensions/pathname.rb
[debug]: Parsing lib/jamf/api/connection/api_error.rb
[warn]: @param tag has unknown parameter name: rest_error
in file `lib/jamf/api/connection/api_error.rb' near line 83
[debug]: Parsing lib/jamf/api/json_objects/country.rb
[debug]: Parsing lib/jamf/client/management_action.rb
[debug]: Parsing lib/jamf/ruby_extensions/filetest.rb
[debug]: Parsing lib/jamf/ruby_extensions/pathname.rb
[debug]: Parsing lib/jss/api_object/netboot_server.rb
[debug]: Parsing lib/jss/api_object/scopable/scope.rb
[debug]: Parsing lib/jamf/api/json_objects/location.rb
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 34
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 41
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 48
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 55
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 62
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 69
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 76
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/location.rb' near line 83
[debug]: Parsing lib/jamf/api/mixins/bulk_deletable.rb
[debug]: Parsing lib/jss/api_object/advanced_search.rb
[debug]: Parsing lib/jss/api_object/mac_application.rb
[debug]: Parsing lib/jss/api_object/network_segment.rb
[warn]: @param tag has unknown parameter name: starting
in file `lib/jss/api_object/network_segment.rb' near line 165
[warn]: Unknown tag @see_also in file `lib/jss/api_object/network_segment.rb` near line 291
[warn]: @param tag has unknown parameter name: other_segment
in file `lib/jss/api_object/network_segment.rb' near line 363
[warn]: Unknown tag @see_also in file `lib/jss/api_object/network_segment.rb` near line 514
[debug]: Parsing lib/jss/api_object/peripheral_type.rb
[debug]: Parsing lib/jamf/api/json_objects/criterion.rb
[debug]: Parsing lib/jss/api_object/group/user_group.rb
[debug]: Parsing lib/jamf/api/json_objects/attachment.rb
[debug]: Parsing lib/jamf/ruby_extensions/array/utils.rb
[debug]: Parsing lib/jss/api_object/removable_macaddr.rb
[debug]: Parsing lib/jamf/api/json_objects/ios_details.rb
[debug]: Parsing lib/jamf/ruby_extensions/ipaddr/utils.rb
[debug]: Parsing lib/jss/api_object/distribution_point.rb
[debug]: Parsing lib/jss/api_object/management_history.rb
[debug]: Parsing lib/jss/api_object/self_servable/icon.rb
[debug]: Parsing lib/jamf/api/abstract_classes/prestage.rb
[warn]: Unknown tag @paream in file `lib/jamf/api/abstract_classes/prestage.rb` near line 236
[warn]: Unknown tag @paream in file `lib/jamf/api/abstract_classes/prestage.rb` near line 281
[debug]: Parsing lib/jamf/api/abstract_classes/resource.rb
[warn]: Unknown tag @see_also in file `lib/jamf/api/abstract_classes/resource.rb` near line 181
[debug]: Parsing lib/jss/api_object/computer_invitation.rb
[debug]: Parsing lib/jss/api_object/extension_attribute.rb
[warn]: @param tag has unknown parameter name: new_val
in file `lib/jss/api_object/extension_attribute.rb' near line 361
[debug]: Parsing lib/jss/api_object/patch_title/version.rb
[debug]: Parsing lib/jss/api_object/restricted_software.rb
[debug]: Parsing lib/jamf/api/json_objects/account_prefs.rb
[debug]: Parsing lib/jamf/ruby_extensions/hash/backports.rb
[debug]: Parsing lib/jamf/ruby_extensions/pathname/utils.rb
[debug]: Parsing lib/jss/api_object/criteriable/criteria.rb
[debug]: Parsing lib/jss/api_object/group/computer_group.rb
[debug]: Parsing lib/jamf/api/attribute_classes/timestamp.rb
[debug]: Parsing lib/jamf/api/json_objects/prestage_scope.rb
[debug]: Parsing lib/jss/api_object/configuration_profile.rb
[debug]: Parsing lib/jss/api_object/criteriable/criterion.rb
[warn]: @param tag has unknown parameter name: side
in file `lib/jss/api_object/criteriable/criterion.rb' near line 169
[debug]: Parsing lib/jss/ruby_extensions/string/backports.rb
[debug]: Parsing lib/jamf/api/abstract_classes/json_object.rb
[debug]: Parsing lib/jamf/api/attribute_classes/ip_address.rb
[debug]: Parsing lib/jamf/api/json_objects/android_details.rb
[debug]: Parsing lib/jamf/api/json_objects/appletv_details.rb
[debug]: Parsing lib/jamf/api/json_objects/installed_ebook.rb
[debug]: Parsing lib/jamf/api/json_objects/purchasing_data.rb
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 36
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 43
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 50
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 57
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 64
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 71
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 78
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 85
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 92
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 99
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 106
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/purchasing_data.rb' near line 113
[debug]: Parsing lib/jamf/ruby_extensions/array/predicates.rb
[debug]: Parsing lib/jamf/ruby_extensions/string/backports.rb
[debug]: Parsing lib/jss/api_object/software_update_server.rb
[debug]: Parsing lib/jss/ruby_extensions/string/predicates.rb
[debug]: Parsing lib/jamf/api/json_objects/cellular_network.rb
[debug]: Parsing lib/jamf/api/json_objects/change_log_entry.rb
[debug]: Parsing lib/jamf/api/json_objects/md_prestage_name.rb
[debug]: Parsing lib/jamf/ruby_extensions/object/predicates.rb
[debug]: Parsing lib/jamf/ruby_extensions/string/predicates.rb
[debug]: Parsing lib/jss/ruby_extensions/string/conversions.rb
[debug]: Parsing lib/jamf/api/json_objects/md_prestage_names.rb
[debug]: Parsing lib/jamf/api/json_objects/prestage_location.rb
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 43
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 50
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 57
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 64
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 71
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 78
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 85
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_location.rb' near line 92
[debug]: Parsing lib/jamf/ruby_extensions/string/conversions.rb
[debug]: Parsing lib/jss/api_object/management_history/ebook.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/ebook.rb':42:

42: class EBook < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/connection/api_error_styleguide.rb
[debug]: Parsing lib/jamf/ruby_extensions/filetest/predicates.rb
[debug]: Parsing lib/jamf/ruby_extensions/pathname/predicates.rb
[debug]: Parsing lib/jss/api_object/group/mobile_device_group.rb
[debug]: Parsing lib/jss/api_object/mobile_device_application.rb
[debug]: Parsing lib/jamf/api/abstract_classes/advanced_search.rb
[debug]: Parsing lib/jamf/api/json_objects/prestage_assignment.rb
[debug]: Parsing lib/jamf/api/json_objects/prestage_sync_status.rb
[debug]: Parsing lib/jss/api_object/management_history/hashlike.rb
[debug]: Parsing lib/jamf/api/abstract_classes/generic_reference.rb
[debug]: Parsing lib/jamf/api/json_objects/installed_application.rb
[debug]: Parsing lib/jamf/api/json_objects/installed_certificate.rb
[debug]: Parsing lib/jamf/api/json_objects/mobile_device_details.rb
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/mobile_device_details.rb' near line 90
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/mobile_device_details.rb' near line 99
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/mobile_device_details.rb' near line 115
[warn]: @param tag has unknown parameter name: @see
in file `lib/jamf/api/json_objects/mobile_device_details.rb' near line 162
[debug]: Parsing lib/jamf/api/abstract_classes/singleton_resource.rb
[warn]: @param tag has unknown parameter name: version
in file `lib/jamf/api/abstract_classes/singleton_resource.rb' near line 58
[debug]: Parsing lib/jamf/api/json_objects/mobile_device_security.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/site.rb
[debug]: Parsing lib/jss/api_object/computer/application_installs.rb
[debug]: Parsing lib/jss/api_object/management_history/policy_log.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/policy_log.rb':38:

38: class PolicyLog < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/abstract_classes/collection_resource.rb
[warn]: @param tag has unknown parameter name: ident:
in file `lib/jamf/api/abstract_classes/collection_resource.rb' near line 210
[debug]: Parsing lib/jss/api_object/management_history/audit_event.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/audit_event.rb':38:

38: class AuditEvent < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/mdm_command.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/mdm_command.rb':41:

41: class MDMCommand < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/json_objects/device_enrollment_device.rb
[debug]: Parsing lib/jamf/api/json_objects/prestage_purchasing_data.rb
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 43
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 50
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 57
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 64
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 71
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 78
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 85
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 92
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 99
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 106
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 113
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/json_objects/prestage_purchasing_data.rb' near line 120
[debug]: Parsing lib/jamf/api/resources/collection_resources/script.rb
[debug]: Parsing lib/jamf/api/json_objects/extension_attribute_value.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/account.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/building.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/category.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/computer.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/time_zone.rb
[debug]: Parsing lib/jss/api_object/patch_source/patch_external_source.rb
[debug]: Parsing lib/jss/api_object/patch_source/patch_internal_source.rb
[debug]: Parsing lib/jamf/api/json_objects/md_prestage_skip_setup_items.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/department.rb
[debug]: Parsing lib/jamf/api/abstract_classes/prestage_skip_setup_items.rb
[debug]: Parsing lib/jamf/api/json_objects/device_enrollment_sync_status.rb
[debug]: Parsing lib/jss/api_object/advanced_search/advanced_user_search.rb
[debug]: Parsing lib/jss/api_object/management_history/casper_remote_log.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/casper_remote_log.rb':38:

38: class CasperRemoteLog < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/mac_app_store_app.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/mac_app_store_app.rb':41:

41: class MacAppStoreApp < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/mobile_device_app.rb
[warn]: @param tag has unknown parameter name: A
in file `lib/jss/api_object/management_history/mobile_device_app.rb' near line 110
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/mobile_device_app.rb':41:

41: class MobileDeviceApp < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/json_objects/installed_provisioning_profile.rb
[debug]: Parsing lib/jamf/api/resources/singleton_resources/authorization.rb
[debug]: Parsing lib/jss/api_object/management_history/casper_imaging_log.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/casper_imaging_log.rb':38:

38: class CasperImagingLog < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/computer_usage_log.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/computer_usage_log.rb':38:

38: class ComputerUsageLog < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/management_history/screen_sharing_log.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/screen_sharing_log.rb':38:

38: class ScreenSharingLog < ImmutableStruct.new(

[debug]: Parsing lib/jamf/api/json_objects/installed_configuration_profile.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/mobile_device.rb
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/resources/collection_resources/mobile_device.rb' near line 86
[warn]: @param tag has unknown parameter name:
in file `lib/jamf/api/resources/collection_resources/mobile_device.rb' near line 139
[debug]: Parsing lib/jss/api_object/management_history/user_location_change.rb
[warn]: in YARD::Handlers::Ruby::ClassHandler: Undocumentable superclass (class was added without superclass)
in file 'lib/jss/api_object/management_history/user_location_change.rb':38:

38: class UserLocationChange < ImmutableStruct.new(

[debug]: Parsing lib/jss/api_object/advanced_search/advanced_computer_search.rb
[debug]: Parsing lib/jamf/api/json_objects/computer_prestage_skip_setup_items.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/computer_prestage.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/device_enrollment.rb
[warn]: Unknown tag @pararm in file `lib/jamf/api/resources/collection_resources/device_enrollment.rb` near line 251
[debug]: Parsing lib/jamf/api/json_objects/inventory_preload_extension_attribute.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/extension_attribute.rb
[debug]: Parsing lib/jss/api_object/extension_attribute/user_extension_attribute.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/advanced_user_search.rb
[debug]: Parsing lib/jamf/api/resources/singleton_resources/reenrollment_settings.rb
[warn]: @param tag has unknown parameter name: a
in file `lib/jamf/api/resources/singleton_resources/reenrollment_settings.rb' near line 82
[debug]: Parsing lib/jss/api_object/advanced_search/advanced_mobile_device_search.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/mobile_device_prestage.rb
[debug]: Parsing lib/jamf/api/resources/singleton_resources/app_store_country_codes.rb
[warn]: @param tag has unknown parameter name: name
in file `lib/jamf/api/resources/singleton_resources/app_store_country_codes.rb' near line 125
[debug]: Parsing lib/jamf/api/resources/singleton_resources/client_checkin_settings.rb
[debug]: Parsing lib/jss/api_object/configuration_profile/osx_configuration_profile.rb
[debug]: Parsing lib/jss/api_object/extension_attribute/computer_extension_attribute.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/inventory_preload_record.rb
[debug]: Parsing lib/jss/api_object/extension_attribute/mobile_device_extension_attribute.rb
[debug]: Parsing lib/jamf/api/resources/collection_resources/advanced_mobile_device_search.rb
[debug]: Parsing lib/jss/api_object/configuration_profile/mobile_device_configuration_profile.rb
[debug]: Serializing to .yardoc/objects/root.dat
[debug]: Re-generating object ...
[debug]: Re-generating object JSS...
[debug]: Re-generating object JSS::Composer...
[debug]: Re-generating object JSS::Creatable...
[debug]: Re-generating object JSS::FileUpload...
[debug]: Re-generating object JSS::Locatable...
[debug]: Re-generating object JSS::Matchable...
[debug]: Re-generating object JSS::Purchasable...
[debug]: Re-generating object JSS::Updatable...
[debug]: Re-generating object JSS::Extendable...
[debug]: Re-generating object JSS::SelfServable...
[debug]: Re-generating object JSS::Categorizable...
[debug]: Re-generating object JSS::VPPable...
[debug]: Re-generating object JSS::Sitable...
[debug]: Re-generating object JSS::MDM...
[debug]: Re-generating object JSS::ManagementHistory...
[debug]: Re-generating object JSS::Criteriable...
[debug]: Re-generating object JSS::Scopable...
[debug]: Re-generating object Jamf...
[debug]: Re-generating object JSS::Validate...
[debug]: Re-generating object Jamf::Composer...
[debug]: Re-generating object Jamf::Validate...
[debug]: Re-generating object JSS::MDM::ClassMethods...
[debug]: Re-generating object JSS::XMLWorkaround...
[debug]: Re-generating object Jamf::Abstract...
[debug]: Re-generating object Jamf::Lockable...
[debug]: Re-generating object Jamf::Immutable...
[debug]: Re-generating object Jamf::Locatable...
[debug]: Re-generating object Jamf::Referable...
[debug]: Re-generating object JSS::Uploadable...
[debug]: Re-generating object Jamf::ChangeLog...
[debug]: Re-generating object Jamf::Extendable...
[debug]: Re-generating object Jamf::Searchable...
[debug]: Re-generating object Jamf::UnCreatable...
[debug]: Re-generating object Jamf::UnDeletable...
[debug]: Re-generating object FileTest...
[debug]: Re-generating object JamfRubyExtensions...
[debug]: Re-generating object JamfRubyExtensions::Array...
[debug]: Re-generating object JamfRubyExtensions::Array::Utils...
[debug]: Re-generating object JamfRubyExtensions::IPAddr...
[debug]: Re-generating object JamfRubyExtensions::IPAddr::Utils...
[debug]: Re-generating object JSS::ManagementHistory::ClassMethods...
[debug]: Re-generating object JamfRubyExtensions::Hash...
[debug]: Re-generating object JamfRubyExtensions::Hash::BackPorts...
[debug]: Re-generating object JamfRubyExtensions::Pathname...
[debug]: Re-generating object JamfRubyExtensions::Pathname::Utils...
[debug]: Re-generating object JSSRubyExtensions...
[debug]: Re-generating object JSSRubyExtensions::String...
[debug]: Re-generating object JSSRubyExtensions::String::BackPorts...
[debug]: Re-generating object JamfRubyExtensions::Array::Predicates...
[debug]: Re-generating object JamfRubyExtensions::String...
[debug]: Re-generating object JamfRubyExtensions::String::BackPorts...
[debug]: Re-generating object JSSRubyExtensions::String::Predicates...
[debug]: Re-generating object JamfRubyExtensions::Object...
[debug]: Re-generating object JamfRubyExtensions::Object::Predicates...
[debug]: Re-generating object JamfRubyExtensions::String::Predicates...
[debug]: Re-generating object JSSRubyExtensions::String::Conversions...
[debug]: Re-generating object JamfRubyExtensions::String::Conversions...
[debug]: Re-generating object JamfRubyExtensions::FileTest...
[debug]: Re-generating object JamfRubyExtensions::FileTest::Predicates...
[debug]: Re-generating object JamfRubyExtensions::Pathname::Predicates...
[debug]: Re-generating object JSS::ManagementHistory::HashLike...
[debug]: Re-generating object JSS::Criteriable::Criteria...
[debug]: Re-generating object JSS::Criteriable::Criterion...
[debug]: Re-generating object JSS::Scopable::Scope...
[debug]: Re-generating object JSS::APIConnection...
[debug]: Re-generating object JSS::DBConnection...
[debug]: Re-generating object JSS::Server...
[debug]: Re-generating object JSS::Icon...
[debug]: Re-generating object JSS::Preferences...
[debug]: Re-generating object JSS::Client...
[debug]: Re-generating object JSS::APIObject...
[debug]: Re-generating object JSS::AdvancedSearch...
[debug]: Re-generating object JSS::AdvancedComputerSearch...
[debug]: Re-generating object JSS::AdvancedMobileDeviceSearch...
[debug]: Re-generating object JSS::AdvancedUserSearch...
[debug]: Re-generating object JSS::ExtensionAttribute...
[debug]: Re-generating object JSS::ComputerExtensionAttribute...
[debug]: Re-generating object JSS::MobileDeviceExtensionAttribute...
[debug]: Re-generating object JSS::UserExtensionAttribute...
[debug]: Re-generating object JSS::Group...
[debug]: Re-generating object JSS::ComputerGroup...
[debug]: Re-generating object JSS::MobileDeviceGroup...
[debug]: Re-generating object JSS::UserGroup...
[debug]: Re-generating object JSS::ConfigurationProfile...
[debug]: Re-generating object JSS::OSXConfigurationProfile...
[debug]: Re-generating object JSS::MobileDeviceConfigurationProfile...
[debug]: Re-generating object JSS::Account...
[debug]: Re-generating object JSS::Building...
[debug]: Re-generating object JSS::Category...
[debug]: Re-generating object JSS::Computer...
[debug]: Re-generating object JSS::Department...
[debug]: Re-generating object JSS::EBook...
[debug]: Re-generating object JSS::DistributionPoint...
[debug]: Re-generating object JSS::LDAPServer...
[debug]: Re-generating object JSS::MacApplication...
[debug]: Re-generating object JSS::MobileDevice...
[debug]: Re-generating object JSS::MobileDeviceApplication...
[debug]: Re-generating object JSS::NetBootServer...
[debug]: Re-generating object JSS::NetworkSegment...
[debug]: Re-generating object JSS::Package...
[debug]: Re-generating object JSS::PatchPolicy...
[debug]: Re-generating object JSS::PeripheralType...
[debug]: Re-generating object JSS::Peripheral...
[debug]: Re-generating object JSS::Policy...
[debug]: Re-generating object JSS::RemovableMacAddress...
[debug]: Re-generating object JSS::RestrictedSoftware...
[debug]: Re-generating object JSS::Script...
[debug]: Re-generating object JSS::Site...
[debug]: Re-generating object JSS::SoftwareUpdateServer...
[debug]: Re-generating object JSS::User...
[debug]: Re-generating object JSS::WebHook...
[debug]: Re-generating object JSS::MissingDataError...
[debug]: Re-generating object JSS::InvalidDataError...
[debug]: Re-generating object JSS::InvalidConnectionError...
[debug]: Re-generating object JSS::NoSuchItemError...
[debug]: Re-generating object JSS::AlreadyExistsError...
[debug]: Re-generating object JSS::AmbiguousError...
[debug]: Re-generating object JSS::FileServiceError...
[debug]: Re-generating object JSS::UnmanagedError...
[debug]: Re-generating object JSS::UnsupportedError...
[debug]: Re-generating object JSS::TimeoutError...
[debug]: Re-generating object JSS::AuthenticationError...
[debug]: Re-generating object JSS::ConflictError...
[debug]: Re-generating object JSS::BadRequestError...
[debug]: Re-generating object JSS::APIRequestError...
[debug]: Re-generating object Jamf::MissingDataError...
[debug]: Re-generating object Jamf::InvalidDataError...
[debug]: Re-generating object Jamf::InvalidConnectionError...
[debug]: Re-generating object Jamf::NoSuchItemError...
[debug]: Re-generating object Jamf::AlreadyExistsError...
[debug]: Re-generating object Jamf::FileServiceError...
[debug]: Re-generating object Jamf::UnmanagedError...
[debug]: Re-generating object Jamf::UnsupportedError...
[debug]: Re-generating object Jamf::TimeoutError...
[debug]: Re-generating object Jamf::AuthenticationError...
[debug]: Re-generating object Jamf::ConflictError...
[debug]: Re-generating object Jamf::VersionLockError...
[debug]: Re-generating object Jamf::BadRequestError...
[debug]: Re-generating object Jamf::APIRequestError...
[debug]: Re-generating object Hash...
[debug]: Re-generating object Array...
[debug]: Re-generating object String...
[debug]: Re-generating object JSS::Configuration...
[debug]: Re-generating object Jamf::Configuration...
[debug]: Re-generating object Jamf::Connection...
[debug]: Re-generating object JSS::IBeacon...
[debug]: Re-generating object Time...
[debug]: Re-generating object Jamf::Connection::Token...
[debug]: Re-generating object Jamf::Locatable::User...
[debug]: Re-generating object Jamf::Searchable::OrderBy...
[debug]: Re-generating object Jamf::Searchable::SeachParams...
[debug]: Re-generating object JSS::PatchTitle...
[debug]: Re-generating object IPAddr...
[debug]: Re-generating object Object...
[debug]: Re-generating object JSS::PatchSource...
[debug]: Re-generating object Pathname...
[debug]: Re-generating object Jamf::Connection::APIError...
[debug]: Re-generating object Jamf::Country...
[debug]: Re-generating object Jamf::Location...
[debug]: Re-generating object Jamf::Criterion...
[debug]: Re-generating object Jamf::Attachment...
[debug]: Re-generating object Jamf::IosDetails...
[debug]: Re-generating object Jamf::Prestage...
[debug]: Re-generating object Jamf::Resource...
[debug]: Re-generating object JSS::ComputerInvitation...
[debug]: Re-generating object JSS::PatchTitle::Version...
[debug]: Re-generating object Jamf::AccountPreferences...
[debug]: Re-generating object Jamf::Timestamp...
[debug]: Re-generating object Jamf::PrestageScope...
[debug]: Re-generating object Jamf::JSONObject...
[debug]: Re-generating object Jamf::IPAddress...
[debug]: Re-generating object Jamf::AndroidDetails...
[debug]: Re-generating object Jamf::AppleTVDetails...
[debug]: Re-generating object Jamf::InstalledEBook...
[debug]: Re-generating object Jamf::PurchasingData...
[debug]: Re-generating object Jamf::CellularNetwork...
[debug]: Re-generating object Jamf::ChangeLogEntry...
[debug]: Re-generating object Jamf::MobileDevicePrestageName...
[debug]: Re-generating object Jamf::MobileDevicePrestageNames...
[debug]: Re-generating object Jamf::PrestageLocation...
[debug]: Re-generating object JSS::ManagementHistory::EBook...
[debug]: Re-generating object Jamf::APIError...
[debug]: Re-generating object Jamf::APIErrorDetail...
[debug]: Re-generating object Jamf::AdvancedSearch...
[debug]: Re-generating object Jamf::PrestageAssignment...
[debug]: Re-generating object Jamf::PrestageSyncStatus...
[debug]: Re-generating object Jamf::GenericReference...
[debug]: Re-generating object Jamf::InstalledApplication...
[debug]: Re-generating object Jamf::InstalledCertificate...
[debug]: Re-generating object Jamf::MobileDeviceDetails...
[debug]: Re-generating object Jamf::SingletonResource...
[debug]: Re-generating object Jamf::MobileDeviceSecurity...
[debug]: Re-generating object Jamf::Site...
[debug]: Re-generating object JSS::ManagementHistory::PolicyLog...
[debug]: Re-generating object Jamf::CollectionResource...
[debug]: Re-generating object JSS::ManagementHistory::AuditEvent...
[debug]: Re-generating object JSS::ManagementHistory::MDMCommand...
[debug]: Re-generating object Jamf::DeviceEnrollmentDevice...
[debug]: Re-generating object Jamf::PrestagePurchasingData...
[debug]: Re-generating object Jamf::Script...
[debug]: Re-generating object Jamf::ExtensionAttributeValue...
[debug]: Re-generating object Jamf::Account...
[debug]: Re-generating object Jamf::Building...
[debug]: Re-generating object Jamf::Category...
[debug]: Re-generating object Jamf::Computer...
[debug]: Re-generating object Jamf::TimeZone...
[debug]: Re-generating object JSS::PatchExternalSource...
[debug]: Re-generating object JSS::PatchInternalSource...
[debug]: Re-generating object Jamf::MobileDevicePrestageSkipSetupItems...
[debug]: Re-generating object Jamf::Department...
[debug]: Re-generating object Jamf::PrestageSkipSetupItems...
[debug]: Re-generating object Jamf::DeviceEnrollmentSyncStatus...
[debug]: Re-generating object JSS::ManagementHistory::CasperRemoteLog...
[debug]: Re-generating object JSS::ManagementHistory::MacAppStoreApp...
[debug]: Re-generating object JSS::ManagementHistory::MobileDeviceApp...
[debug]: Re-generating object Jamf::InstalledProvisioningProfile...
[debug]: Re-generating object Jamf::Authorization...
[debug]: Re-generating object JSS::ManagementHistory::CasperImagingLog...
[debug]: Re-generating object JSS::ManagementHistory::ComputerUsageLog...
[debug]: Re-generating object JSS::ManagementHistory::ScreenSharingLog...
[debug]: Re-generating object Jamf::InstalledConfigurationProfile...
[debug]: Re-generating object Jamf::MobileDevice...
[debug]: Re-generating object JSS::ManagementHistory::UserLocationChange...
[debug]: Re-generating object Jamf::ComputerPrestageSkipSetupItems...
[debug]: Re-generating object Jamf::ComputerPrestage...
[debug]: Re-generating object Jamf::DeviceEnrollment...
[debug]: Re-generating object Jamf::InventoryPreloadExtensionAttribute...
[debug]: Re-generating object Jamf::ExtensionAttribute...
[debug]: Re-generating object Jamf::AdvancedUserSearch...
[debug]: Re-generating object Jamf::ReEnrollmentSettings...
[debug]: Re-generating object Jamf::MobileDevicePrestage...
[debug]: Re-generating object Jamf::AppStoreCountryCodes...
[debug]: Re-generating object Jamf::ClientCheckInSettings...
[debug]: Re-generating object Jamf::InventoryPreloadRecord...
[debug]: Re-generating object Jamf::AdvancedMobileDeviceSearch...
[debug]: Generating asset js/jquery.js
[debug]: Serializing to /tmp/fixyard/js/jquery.js
[debug]: Generating asset js/app.js
[debug]: Serializing to /tmp/fixyard/js/app.js
[debug]: Generating asset js/full_list.js
[debug]: Serializing to /tmp/fixyard/js/full_list.js
[debug]: Generating asset css/style.css
[debug]: Serializing to /tmp/fixyard/css/style.css
[debug]: Generating asset css/common.css
[debug]: Serializing to /tmp/fixyard/css/common.css
[debug]: Generating asset css/full_list.css
[debug]: Serializing to /tmp/fixyard/css/full_list.css
[debug]: Generating asset class_list.html
[debug]: Serializing to /tmp/fixyard/class_list.html
[debug]: Generating asset method_list.html
[debug]: Serializing to /tmp/fixyard/method_list.html
[debug]: Generating asset file_list.html
[debug]: Serializing to /tmp/fixyard/file_list.html
[debug]: Generating asset frames.html
[debug]: Serializing to /tmp/fixyard/frames.html
[debug]: Serializing to /tmp/fixyard/_index.html
Traceback (most recent call last):
51: from /usr/local/bin/yard:23:in `<main>'
50: from /usr/local/bin/yard:23:in `load'
49: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/bin/yard:13:in `<top (required)>'
48: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/command_parser.rb:54:in `run'
47: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/command_parser.rb:72:in `run'
46: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/command.rb:14:in `run'
45: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/yardoc.rb:267:in `run'
44: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/cli/yardoc.rb:356:in `run_generate'
43: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/engine.rb:105:in `generate'
42: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:136:in `run'
41: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:131:in `new'
40: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:193:in `initialize'
39: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:10:in `init'
38: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:10:in `each_with_index'
37: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:10:in `each'
36: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:11:in `block in init'
35: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:68:in `serialize_file'
34: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:51:in `serialize_index'
33: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/engine.rb:121:in `with_serializer'
32: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/logging.rb:82:in `capture'
31: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/engine.rb:123:in `block in with_serializer'
30: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/fulldoc/html/setup.rb:52:in `block in serialize_index'
29: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:136:in `run'
28: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:255:in `run'
27: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:398:in `add_options'
26: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:in `block in run'
25: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:in `each'
24: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:259:in `block (2 levels) in run'
23: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:367:in `render_section'
22: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/layout/html/setup.rb:62:in `layout'
21: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:287:in `erb'
20: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/layout/html/layout.erb:21:in `_erb_cache_5'
19: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:277:in `yieldall'
18: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:412:in `with_section'
17: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:277:in `block in yieldall'
16: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:255:in `run'
15: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:398:in `add_options'
14: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:in `block in run'
13: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:256:in `each'
12: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:259:in `block (2 levels) in run'
11: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/template.rb:367:in `render_section'
10: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/templates/default/layout/html/setup.rb:67:in `diskfile'
9: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:67:in `htmlify'
8: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:220:in `resolve_links'
7: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:220:in `gsub'
6: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:248:in `block in resolve_links'
5: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/base_helper.rb:94:in `linkify'
4: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/templates/helpers/html_helper.rb:296:in `link_object'
3: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/registry.rb:304:in `resolve'
2: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/registry_resolver.rb:90:in `lookup_by_path'
1: from /Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/registry_resolver.rb:90:in `new'
/Users/chrisl/Dropbox/etc/personal-gems/gems/yard-0.9.24/lib/yard/code_objects/proxy.rb:62:in `initialize': constant mapping (YARD::Parser::UndocumentableError)



Loren Segal

unread,
Jan 13, 2020, 4:50:41 PM1/13/20
to yar...@googlegroups.com

Hello!

Based on a look at the stack trace, the error is coming while generating HTML for an extra file. With a bit of extra debugging, it looks like it's coming from your README.md, specifically the one reference to {JSS::API#connect}. The error being raised is due to an inconsistency in the parsed data, in which you're referencing #connect as an instance method of JSS::API, but JSS::API is defined as a constant, and therefore cannot contain methods. It looks like API is defined as such here:

https://github.com/PixarAnimationStudios/ruby-jss/blob/bf07239ef08a0e8a8fb255a8d847c323c0ad26c6/lib/jss/api_connection.rb#L1346

I'm not entirely sure why this only started to fail in 0.9.22, but based on way the code is structured, it does seem like "intended behavior" for YARD to be unable to link to the method using that specific path, so it's possible we fixed a bug in parsing that unintentionally started detecting this incorrect link.

THAT SAID, this shouldn't cause a crash during generation, and YARD should have been able to recover from this and generate a warning rather than fail altogether. We can also make the message more descriptive (though if it were a non-crash warning you would have had the context for the link in question printed alongside the error). That seems like something we can fix in an upcoming release. Opening an issue for this on GitHub would be the easiest way to track progress on when that goes out.

Until then, the easiest workaround would be to remove/replace the link to that object, that seems to get things working on my end.

Hope that helps!

Loren

chr...@pixar.com

unread,
Jan 15, 2020, 1:56:30 PM1/15/20
to YARD
Thanks so much Loren!

I'll go remove the link for now, and get an issue opened asap.

Cheers!
-Chris
Reply all
Reply to author
Forward
0 new messages