Fix block comments in src

This commit is contained in:
Garen Torikian 2013-04-23 11:16:56 -07:00
parent 64fea21a38
commit 2357f46761
39 changed files with 76 additions and 224 deletions

View File

@ -6,9 +6,7 @@ $ = require 'jquery'
CSON = require 'cson'
###
# Internal: Loads and resolves packages. #
###
### Internal: Loads and resolves packages. ###
module.exports =
class AtomPackage extends Package

View File

@ -5,9 +5,7 @@ fsUtils = require 'fs-utils'
Specificity = require 'specificity'
PEG = require 'pegjs'
###
# Internal #
###
### Internal ###
module.exports =
class BindingSet

View File

@ -1,9 +1,7 @@
Range = require 'range'
_ = require 'underscore'
###
# Internal #
###
### Internal ###
module.exports =
class BufferChangeOperation

View File

@ -10,16 +10,12 @@ class BufferMarker
suppressObserverNotification: false
invalidationStrategy: null
###
# Internal #
###
### Internal ###
constructor: ({@id, @buffer, range, @invalidationStrategy, noTail, reverse}) ->
@invalidationStrategy ?= 'contains'
@setRange(range, {noTail, reverse})
###
# Public #
###
### Public ###
# Public: Sets the marker's range, potentialy modifying both its head and tail.
#
@ -148,9 +144,7 @@ class BufferMarker
unobserve: (callback) ->
@off 'changed', callback
###
# Internal #
###
### Internal ###
tryToInvalidate: (changedRange) ->
betweenStartAndEnd = @getRange().containsRange(changedRange, exclusive: false)

View File

@ -29,9 +29,7 @@ class Config
settings: null
configFileHasErrors: null
###
# Internal #
###
### Internal ###
constructor: ->
@defaultSettings =

View File

@ -3,7 +3,7 @@ Point = require 'point'
Range = require 'range'
_ = require 'underscore'
# Internal:
### Internal ###
module.exports =
class CursorView extends View
@content: ->

View File

@ -14,10 +14,8 @@ class Cursor
visible: true
needsAutoscroll: null
###
# Internal #
###
### Internal ###
constructor: ({@editSession, @marker}) ->
@updateVisibility()
@editSession.observeMarker @marker, (e) =>
@ -53,9 +51,7 @@ class Cursor
unless fn()
@trigger 'autoscrolled' if @needsAutoscroll
###
# Public #
###
### Public ###
# Public: Moves a cursor to a given screen position.
#

View File

@ -51,9 +51,7 @@ class Directory
directories.concat(files)
###
# Internal #
###
### Internal ###
afterSubscribe: ->
@subscribeToNativeChangeEvents() if @subscriptionCount() == 1

View File

@ -9,16 +9,12 @@ class DisplayBufferMarker
tailScreenPosition: null
valid: true
###
# Internal #
###
### Internal ###
constructor: ({@id, @displayBuffer}) ->
@buffer = @displayBuffer.buffer
###
# Public #
###
### Public ###
# Public: Gets the screen range of the display marker.
#
@ -127,9 +123,7 @@ class DisplayBufferMarker
@off 'changed', callback
@unobserveBufferMarkerIfNeeded()
###
# Internal #
###
### Internal ###
observeBufferMarkerIfNeeded: ->
return if @subscriptionCount()

View File

@ -18,9 +18,7 @@ class DisplayBuffer
foldsById: null
markers: null
###
# Internal #
###
### Internal ###
constructor: (@buffer, options={}) ->
@id = @constructor.idCounter++
@ -45,9 +43,7 @@ class DisplayBuffer
@trigger 'changed', eventProperties
@resumeMarkerObservers()
###
# Public #
###
### Public ###
setVisible: (visible) -> @tokenizedBuffer.setVisible(visible)
@ -332,9 +328,7 @@ class DisplayBuffer
clipScreenPosition: (position, options) ->
@lineMap.clipScreenPosition(position, options)
###
# Internal #
###
### Internal ###
registerFold: (fold) ->
@activeFolds[fold.startRow] ?= []
@ -433,9 +427,7 @@ class DisplayBuffer
lineFragments
###
# Public #
###
### Public ###
# Public: Given a line, finds the point where it would wrap.
#
@ -695,9 +687,7 @@ class DisplayBuffer
observeMarker: (id, callback) ->
@getMarker(id).observe(callback)
###
# Internal #
###
### Internal ###
pauseMarkerObservers: ->
marker.pauseEvents() for marker in @getMarkers()

View File

@ -15,9 +15,7 @@ module.exports =
class EditSession
registerDeserializer(this)
###
# Internal #
###
### Internal ###
@version: 1
@ -93,9 +91,7 @@ class EditSession
copy: ->
EditSession.deserialize(@serialize(), @project)
###
# Public #
###
### Public ###
# Public: Retrieves the filename of the open file.
#
@ -614,9 +610,7 @@ class EditSession
redo: ->
@buffer.redo(this)
###
# Internal #
###
### Internal ###
transact: (fn) ->
isNewTransaction = @buffer.transact()
@ -639,9 +633,7 @@ class EditSession
abort: ->
@buffer.abort()
###
# Public #
###
### Public ###
# Public: Folds all the rows.
foldAll: ->
@ -897,9 +889,7 @@ class EditSession
@foldCurrentRow() if cursorRowFolded
###
# Internal #
###
### Internal ###
mutateSelectedText: (fn) ->
@transact => fn(selection) for selection in @getSelections()
@ -918,9 +908,7 @@ class EditSession
pushOperation: (operation) ->
@buffer.pushOperation(operation, this)
###
# Public #
###
### Public ###
# Public: Constructs a new marker at the given screen range.
#

View File

@ -27,9 +27,7 @@ class Editor extends View
@nextEditorId: 1
###
# Internal #
###
### Internal ###
@content: (params) ->
attributes = { class: @classes(params), tabindex: -1 }
@ -192,9 +190,7 @@ class Editor extends View
do (name, method) =>
@command name, (e) => method.call(this, e); false
###
# Public #
###
### Public ###
# Public: Retrieves a single cursor
#
@ -796,9 +792,7 @@ class Editor extends View
# iterator - A {Function} that's called on each match
backwardsScanInBufferRange: (args...) -> @getBuffer().backwardsScanInRange(args...)
###
# Internal #
###
### Internal ###
configure: ->
@observeConfig 'editor.showLineNumbers', (showLineNumbers) => @gutter.setShowLineNumbers(showLineNumbers)
@ -986,9 +980,7 @@ class Editor extends View
else
@scrollTop() + @scrollView.height()
###
# Public #
###
### Public ###
# Public: Retrieves the {EditSession}'s buffer.
#
@ -1253,9 +1245,7 @@ class Editor extends View
appendToLinesView: (view) ->
@overlayer.append(view)
###
# Internal #
###
### Internal ###
calculateDimensions: ->
fragment = $('<div class="line" style="position: absolute; visibility: hidden;"><span>x</span></div>')
@ -1497,9 +1487,7 @@ class Editor extends View
@renderedLines.css('padding-bottom', paddingBottom)
@gutter.lineNumbers.css('padding-bottom', paddingBottom)
###
# Public #
###
### Public ###
# Public: Retrieves the number of the row that is visible and currently at the top of the editor.
#
@ -1522,9 +1510,7 @@ class Editor extends View
isScreenRowVisible: (row) ->
@getFirstVisibleScreenRow() <= row <= @getLastVisibleScreenRow()
###
# Internal #
###
### Internal ###
handleScreenLinesChange: (change) ->
@pendingChanges.push(change)
@ -1632,9 +1618,7 @@ class Editor extends View
toggleLineCommentsInSelection: ->
@activeEditSession.toggleLineCommentsInSelection()
###
# Public #
###
### Public ###
# Public: Converts a buffer position to a pixel position.
#
@ -1767,9 +1751,7 @@ class Editor extends View
path = @getPath()
pasteboard.write(path) if path?
###
# Internal #
###
### Internal ###
transact: (fn) -> @activeEditSession.transact(fn)
commit: -> @activeEditSession.commit()

View File

@ -68,9 +68,7 @@ class File
exists: ->
fsUtils.exists(@getPath())
###
# Internal #
###
### Internal ###
afterSubscribe: ->
@subscribeToNativeChangeEvents() if @exists() and @subscriptionCount() == 1

View File

@ -13,9 +13,7 @@ class Fold
startRow: null
endRow: null
###
# Internal #
###
### Internal ###
constructor: (@displayBuffer, @startRow, @endRow) ->
@id = @constructor.idCounter++

View File

@ -29,9 +29,7 @@ class Git
upstream: null
statusTask: null
###
# Internal #
###
### Internal ###
# Internal: Creates a new `Git` object.
#
@ -72,9 +70,7 @@ class Git
@unsubscribe()
###
# Public #
###
### Public ###
# Public: Retrieves the git repository.
#
@ -245,9 +241,7 @@ class Git
getLineDiffs: (path, text) ->
@getRepo().getLineDiffs(@relativize(path), text)
###
# Internal #
###
### Internal ###
refreshStatus: ->
if @statusTask?

View File

@ -9,9 +9,7 @@ _ = require 'underscore'
module.exports =
class Gutter extends View
###
# Internal #
###
### Internal ###
@content: ->
@div class: 'gutter', =>
@ -50,9 +48,7 @@ class Gutter extends View
$(document).on "mousemove.gutter-#{@getEditor().id}", moveHandler
$(document).one "mouseup.gutter-#{@getEditor().id}", => $(document).off 'mousemove', moveHandler
###
# Public #
###
### Public ###
# Public: Retrieves the containing {Editor}.
#
@ -66,9 +62,7 @@ class Gutter extends View
setShowLineNumbers: (showLineNumbers) ->
if showLineNumbers then @lineNumbers.show() else @lineNumbers.hide()
###
# Internal #
###
### Internal ###
updateLineNumbers: (changes, renderFrom, renderTo) ->
if renderFrom < @firstScreenRow or renderTo > @lastScreenRow

View File

@ -21,9 +21,7 @@ class ImageEditSession
'.png'
], fsUtils.extension(path), true) >= 0
###
# Internal #
###
### Internal ###
@deserialize: (state) ->
if fsUtils.exists(state.path)

View File

@ -86,9 +86,7 @@ class ImageView extends ScrollView
@image.height(@originalHeight)
@centerImage()
###
# Internal #
###
### Internal ###
adjustSize: (factor) ->
return unless @loaded and @isVisible()

View File

@ -5,9 +5,7 @@ require 'underscore-extensions'
EventEmitter = require 'event-emitter'
Subscriber = require 'subscriber'
###
# Internal #
###
### Internal ###
module.exports =
class LanguageMode

View File

@ -2,9 +2,7 @@ Token = require 'token'
EventEmitter = require 'event-emitter'
_ = require 'underscore'
###
# Internal #
###
### Internal ###
module.exports =
class NullGrammar
name: 'Null Grammar'

View File

@ -1,8 +1,6 @@
fsUtils = require 'fs-utils'
###
# Internal #
###
### Internal ###
module.exports =
class Package
@build: (path) ->

View File

@ -6,9 +6,7 @@ module.exports =
class PaneContainer extends View
registerDeserializer(this)
###
# Internal #
###
### Internal ###
@deserialize: ({root}) ->
container = new PaneContainer
@ -26,9 +24,7 @@ class PaneContainer extends View
deserializer: 'PaneContainer'
root: @getRoot()?.serialize()
###
# Public #
###
### Public ###
focusNextPane: ->
panes = @getPanes()

View File

@ -2,9 +2,7 @@ $ = require 'jquery'
_ = require 'underscore'
PaneAxis = require 'pane-axis'
###
# Internal #
###
### Internal ###
module.exports =
class PaneRow extends PaneAxis

View File

@ -7,9 +7,7 @@ PaneColumn = require 'pane-column'
module.exports =
class Pane extends View
###
# Internal #
###
### Internal ###
@content: (wrappedView) ->
@div class: 'pane', =>
@ -65,9 +63,7 @@ class Pane extends View
@attached = true
@trigger 'pane:attached', [this]
###
# Public #
###
### Public ###
makeActive: ->
for pane in @getContainer().getPanes() when pane isnt this

View File

@ -172,9 +172,7 @@ class Point
toArray: ->
[@row, @column]
###
# Internal #
###
### Internal ###
inspect: ->
"(#{@row}, #{@column})"

View File

@ -32,9 +32,7 @@ class Project
@editSessions = []
@buffers = []
###
# Internal #
###
### Internal ###
serialize: ->
deserializer: 'Project'
@ -46,9 +44,7 @@ class Project
destroy: ->
editSession.destroy() for editSession in @getEditSessions()
###
# Public #
###
### Public ###
# Public: Retrieves the project path.
#
@ -164,9 +160,7 @@ class Project
getEditSessions: ->
new Array(@editSessions...)
###
# Internal #
###
### Internal ###
buildEditSessionForBuffer: (buffer, editSessionOptions) ->
options = _.extend(@defaultEditSessionOptions(), editSessionOptions)
@ -196,9 +190,7 @@ class Project
else
@on 'buffer-created', (buffer) -> callback(buffer)
###
# Public #
###
### Public ###
# Public: Removes an {EditSession} association from the project.
#

View File

@ -25,9 +25,7 @@ class RootView extends View
disabledPackages: []
themes: ['atom-dark-ui', 'atom-dark-syntax']
###
# Internal:
###
### Internal ###
@content: ({panes}={}) ->
@div id: 'root-view', =>
@ -98,9 +96,7 @@ class RootView extends View
afterAttach: (onDom) ->
@focus() if onDom
###
# Public #
###
### Public ###
# Public: Shows a dialog asking if the pane was _really_ meant to be closed.
confirmClose: ->

View File

@ -1,8 +1,6 @@
_ = require 'underscore'
###
# Internal #
###
### Internal ###
module.exports =
class ScreenLine

View File

@ -6,9 +6,7 @@ fuzzyFilter = require 'fuzzy-filter'
module.exports =
class SelectList extends View
###
# Internal #
###
### Internal ###
@content: ->
@div class: @viewClass(), =>

View File

@ -13,9 +13,7 @@ class Selection
wordwise: false
needsAutoscroll: null
###
# Internal #
###
### Internal ###
constructor: ({@cursor, @marker, @editSession, @goalBufferRange}) ->
@cursor.selection = this
@ -40,9 +38,7 @@ class Selection
clearAutoscroll: ->
@needsAutoscroll = null
###
# Public #
###
### Public ###
# Public: Identifies if the selection is highlighting anything.
#

View File

@ -6,9 +6,7 @@ fsUtils = require 'fs-utils'
EventEmitter = require 'event-emitter'
NullGrammar = require 'null-grammar'
###
# Internal #
###
### Internal ###
module.exports =
class Syntax

View File

@ -55,9 +55,7 @@ class Buffer
@undoManager = new UndoManager(this)
###
# Internal #
###
### Internal ###
destroy: ->
throw new Error("Destroying buffer twice with path '#{@getPath()}'") if @destroyed
@ -98,9 +96,7 @@ class Buffer
@file.on "moved", =>
@trigger "path-changed", this
###
# Public #
###
### Public ###
# Public: Identifies if the buffer belongs to multiple editors.
#
@ -726,9 +722,7 @@ class Buffer
@file? && @file.exists()
###
# Internal #
###
### Internal ###
scheduleModifiedEvents: ->
clearTimeout(@stoppedChangingTimeout) if @stoppedChangingTimeout

View File

@ -8,9 +8,7 @@ EventEmitter = require 'event-emitter'
pathSplitRegex = new RegExp("[#{nodePath.sep}.]")
TextMateScopeSelector = require 'text-mate-scope-selector'
###
# Internal #
###
### Internal ###
module.exports =
class TextMateGrammar
@ -502,9 +500,7 @@ class Pattern
tokens
###
# Internal #
###
### Internal ###
shiftCapture = (captureIndices) ->
[captureIndices.shift(), captureIndices.shift(), captureIndices.shift()]

View File

@ -5,9 +5,7 @@ _ = require 'underscore'
TextMateGrammar = require 'text-mate-grammar'
async = require 'async'
###
# Internal #
###
### Internal ###
module.exports =
class TextMatePackage extends Package

View File

@ -1,6 +1,4 @@
###
# Internal #
###
### Internal ###
class SegmentMatcher
constructor: (segment) ->

View File

@ -3,9 +3,7 @@ fsUtils = require 'fs-utils'
plist = require 'plist'
Theme = require 'theme'
###
# Internal #
###
### Internal ###
module.exports =
class TextMateTheme extends Theme

View File

@ -1,8 +1,6 @@
fsUtils = require 'fs-utils'
###
# Internal #
###
### Internal ###
module.exports =
class Theme

View File

@ -6,9 +6,7 @@ Token = require 'token'
Range = require 'range'
Point = require 'point'
###
# Internal #
###
### Internal ###
module.exports =
class TokenizedBuffer

View File

@ -10,9 +10,7 @@ require 'space-pen-extensions'
deserializers = {}
deferredDeserializers = {}
###
# Internal #
###
### Internal ###
# This method is called in any window needing a general environment, including specs
window.setUpEnvironment = ->